# Seedream 4.0 API on Wizzx - Model ID: `seedream-4` (ByteDance Seedream 4.0) - Submit: `POST https://api.wizzx.ai/api/v1/task/submit/seedream-4` - Status: `GET https://api.wizzx.ai/api/v1/task/{task_id}` - Idempotency: optional `Idempotency-Key: ` header on submit - Auth: header `Authorization: Bearer $WIZZX_API_KEY` (server-side only) - Price: from $0.03/image, billed in credits; failed tasks are refunded - Page: https://wizzx.ai/model/seedream-4 - JSON Schema: https://wizzx.ai/api/models/seedream-4/schema - API reference: https://docs.wizzx.ai/api-reference/endpoint/submit-seedream-4 ## Flow 1. POST the JSON body to the submit URL. The response contains `data.task_id`. 2. Poll `GET /api/v1/task/{task_id}` until `data.status` is `SUCCEEDED`, then read the output URLs from `data.result_urls`. 3. Stop on `FAILED` or `REVIEW_REQUIRED`. Do not resubmit automatically. ## Parameters | Field | Type | Required | Default | Allowed | Description | |---|---|---|---|---|---| | `prompt` | string | yes | | | Describe the image you want to generate | | `image_urls` | url[] ≤ 14 | no | | | Up to 14 reference images for fusion | | `aspect_ratio` | string | no | 1:1 | 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 | | | `resolution` | string | no | 2K | 1K · 2K · 4K | Choose output detail. Resolution does not change the per-image rate. | | `batch_size` | integer | no | 1 | 1 – 15 | Generate 1 to 15 variations in this request. | | `watermark` | boolean | no | false | | | | `seed` | integer | no | | | Random seed for reproducibility | ## Example body ```json { "aspect_ratio": "1:1", "resolution": "2K", "batch_size": 1, "watermark": false, "prompt": "Minimal school textbook illustration of a volcano cut in half vertically, on a white background, landscape 4:3. Flat vector style, soft brown rock and orange magma. Show the entire volcano and a complete small oval underground magma reservoir with white margin underneath. A narrow straight orange vertical tube connects the reservoir to the summit opening. A gray cloud floats above the summit. There are exactly FOUR black text labels total and exactly FOUR thin straight horizontal leader lines. Left lower label \"Magma chamber\": its horizontal line ends in the orange oval underground reservoir. Right middle label \"Conduit\": its horizontal line ends in the orange vertical tube. Left upper label \"Crater\": its horizontal line ends at the summit opening. Right top label \"Ash cloud\": its horizontal line ends inside the gray cloud. Each label appears exactly once. Only these four labels are present. Large readable sans-serif type. Simple uncluttered educational layout." } ```