Image models
Seedream
On this page
Seedream — fast, high-fidelity AI image generation & editing.
| modelId | bytedance-seedream |
| 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 |
|---|---|---|---|
| Default | bytedance-seedream | POST /api/v1/generate | prompt |
| Poll task | — | GET /api/v1/task/{id}?model=bytedance-seedream | — |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The text prompt used to generate the image Max 5000 characters. (default: A weathered brass diving helmet resting on wet cobblestones at dawn, tendrils of sea mist curling around it, warm amber light breaking through the fog, shallow depth of field, cinematic still, ultra-detailed.) |
| image_size | string | No | Select description (options: square | square_hd | portrait_4_3 | portrait_16_9 | landscape_4_3 | landscape_16_9) (default: square_hd) |
| guidance_scale | number | No | Controls how closely the output image aligns with the input prompt. Higher values mean stronger prompt correlation. (range 1-10) (default: 2.5) |
| seed | number | No | Random seed to control the stochasticity of image generation. |
| enable_safety_checker | boolean | No | If set to true, the safety checker will be enabled. (true/false) (default: true) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
Example request
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","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","guidance_scale":2.5,"seed":1,"enable_safety_checker":true,"nsfw_checker":true}}'