API docs / Image models

Seedream 4 API

Generate and edit images from text prompts at up to 4K resolution with unified text-to-image generation and image editing capabilities. Supports multi-reference inputs where multiple images can be provided as references for generation. Handles precise single-sentence editing instructions like removing or replacing objects using natural language prompts. Offers batch generation with sequential image generation mode that can produce multiple related images in one request. Applies diverse visual styles including watercolor, cyberpunk, and architectural styles. Capable of generating complex content such as educational illustrations, charts, timelines, and annotated scenes with strong reasoning abilities.

Model id
bytedance/seedream-4
Provider
Bytedance
Output
Image
Price
From 11 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "bytedance/seedream-4". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-4",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Text prompt for image generation

reference_imagesarray of URLs

Input image(s) for image-to-image generation. List of 1-10 images for single or multi-reference generation.

Default: []

Up to 10 files · Accepts image/*

aspect_ratiostring

Default: match_input_image

One of: match_input_image, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9

enhance_promptboolean

Enable prompt enhancement for higher quality results, this will take longer to generate.

Default: true

sizestring

Default: 2K

One of: 1K, 2K, 4K, custom

heightnumber

Custom image height (only used when size='custom'). Range: 1024-4096 pixels.

Default: 2048

Min 1024 · Max 4096

max_imagesnumber

Maximum number of images to generate when sequential_image_generation='auto'. Range: 1-15. Total images (input + generated) cannot exceed 15.

Default: 1

Min 1 · Max 15

sequential_image_generationstring

Default: disabled

One of: disabled, auto

widthnumber

Custom image width (only used when size='custom'). Range: 1024-4096 pixels.

Default: 2048

Min 1024 · Max 4096