Image models
Seedream 4.0
On this page
Seedream 4.0 — fast, high-fidelity AI image generation & editing.
| modelId | bytedance-seedream-v4-edit, bytedance-seedream-v4-text-to-image |
| Modality | image |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Seedream V4 Edit | bytedance-seedream-v4-edit | POST /api/v1/generate | prompt, image_urls |
| Seedream V4 Text To Image | bytedance-seedream-v4-text-to-image | POST /api/v1/generate | prompt |
| Poll task | — | GET /api/v1/task/{id}?model=bytedance-seedream-v4-edit | — |
Seedream V4 Edit — bytedance-seedream-v4-edit
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt used to edit the image Max 5000 characters. (default: Relight with an iridescent dusk glow, deepening the peacock's plumage into jewel-toned teal and gold with a soft rim light tracing the eye of every feather.) |
| image_urls | string[] | Yes | List of URLs of input images for editing. Presently, up to 10 image inputs are allowed. (image URL) |
| image_size | string | No | The size of the generated image. (options: square | square_hd | portrait_4_3 | portrait_3_2 | portrait_16_9 | landscape_4_3 | landscape_3_2 | landscape_16_9 | landscape_21_9) (default: square_hd) |
| image_resolution | string | No | Final image resolution is determined by combining image_size (aspect ratio) and image_resolution (pixel scale). For example, choosing 4:3 + 4K gives 4096 × 3072px (options: 1K | 2K | 4K) (default: 1K) |
| max_images | number | No | Set this value (1–6) to cap how many images a single generation run can produce in one set—because they’re created in one shot rather than separate requests, you must also state the exact number you want in the prompt so both settings align. (range 1-6) (default: 1) |
| seed | number | No | Random seed to control the stochasticity of image generation. |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"bytedance-seedream-v4-edit","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","image_urls":["https://example.com/input.jpg"],"image_size":"square_hd","image_resolution":"1K","max_images":1,"seed":1,"nsfw_checker":true}}'Seedream V4 Text To Image — bytedance-seedream-v4-text-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt used to generate the image Max 5000 characters. (default: A rain-glazed pedestrian crossing at night seen from directly above, scattered umbrellas dotting the crosswalk like petals, headlight streaks and neon shop signs mirrored in the wet asphalt, cinematic overhead still.) |
| image_size | string | No | The size of the generated image. (options: square | square_hd | portrait_4_3 | portrait_3_2 | portrait_16_9 | landscape_4_3 | landscape_3_2 | landscape_16_9 | landscape_21_9) (default: square_hd) |
| image_resolution | string | No | Final image resolution is determined by combining image_size (aspect ratio) and image_resolution (pixel scale). For example, choosing 4:3 + 4K gives 4096 × 3072px (options: 1K | 2K | 4K) (default: 1K) |
| max_images | number | No | Set this value (1–6) to cap how many images a single generation run can produce in one set—because they’re created in one shot rather than separate requests, you must also state the exact number you want in the prompt so both settings align. (range 1-6) (default: 1) |
| seed | number | No | Random seed to control the stochasticity of image generation |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"bytedance-seedream-v4-text-to-image","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","image_size":"square_hd","image_resolution":"1K","max_images":1,"seed":1,"nsfw_checker":true}}'