seedream-4.0

Seedream 4.0 text-to-image and image-to-image API.

Use doubao-seedream-4-0-250828 with the same synchronous endpoint for text-to-image and image-to-image generation.

Text to image

Create an image

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "A serene mountain landscape at sunrise with misty valleys",
    "size": "1024x1024",
    "seed": 42,
    "watermark": false,
    "logo_info": {"add_logo": false}
  }'

model · string · required

Must be doubao-seedream-4-0-250828.

prompt · string · required

Text prompt for image generation.

size · string

Output image size.

watermark · boolean · default: false

Whether to add a watermark.

seed · integer

Random seed.

logo_info · object

Custom logo and watermark configuration.

logo_info.add_logo · boolean

Whether to add a logo.

logo_info.position · integer

Logo position.

logo_info.language · integer

Logo language.

logo_info.opacity · number

Logo opacity from 0 to 1.

Image to image

Create an image

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "Create three coherent amusement-park images from both references",
    "image": ["https://example.com/ref1.png", "https://example.com/ref2.png"],
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {"max_images": 3},
    "size": "2K",
    "watermark": false
  }'

model · string · required

Must be doubao-seedream-4-0-250828.

prompt · string · required

Image generation or editing prompt.

image · string[] · required

Reference image URLs.

sequential_image_generation · string

Set to auto to generate an image batch.

sequential_image_generation_options.max_images · integer

Maximum number of generated images.

size · string

Output image size.

watermark · boolean · default: false

Whether to add a watermark.

seed · integer

Random seed.

logo_info · object

Custom logo and watermark configuration.

Supported sizes

1024x1024, 864x1152, 1152x864, 1312x736, 736x1312, 832x1248, 1248x832, 1568x672, 2048x2048, 1728x2304, 2304x1728, 2848x1600, 1600x2848, 2496x1664, 1664x2496, 3136x1344, 4096x4096, 3520x4704, 4704x3520, 5504x3040, 3040x5504, 3328x4992, 4992x3328, and 6240x2656.

Headers

Authorization · string · required

Bearer authentication in the form Bearer <token>.

Content-Type · string · default: "application/json" · required

Request body format.

Response

200

{
  "model": "doubao-seedream-4-0-250828",
  "created": 1775029815,
  "data": [{"url": "https://example.com/generated-image.png", "size": "2048x2048"}],
  "usage": {"generated_images": 1, "output_tokens": 16384, "total_tokens": 16384}
}

model · string

Model used for generation.

created · integer

Creation time as a Unix timestamp in seconds.

data · object[]

Generated image list.

data[].url · string

Generated image URL.

data[].size · string

Generated image dimensions.

usage.generated_images · integer

Number of generated images.

usage.output_tokens · integer

Output token count.

usage.total_tokens · integer

Total token count.

Error responses

• 401 Unauthorized — The API key is missing or invalid.
• 429 Rate limit exceeded — The request exceeded the applicable rate limit.