Skip to main content
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "n": 1,
    "metadata": {
      "resolution": "2K"
    }
  }'

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "doubao-seedream-4-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}
  • Seedream 4.0 high-quality image generation model
  • Use model parameter to select doubao-seedream-4-0 model
  • Supports text-to-image generation
  • Async task management, query results by task ID
Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload Image API first to upload images and get URLs, then call this endpoint.

​
Authorizations

​
Authorization
string
required
All endpoints require Bearer Token authenticationGet your API Key from the API Key Management PageAdd to request header:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"doubao-seedream-4-0"
required
Image generation model nameExample: "doubao-seedream-4-0"
​
prompt
string
required
Text description for image generationMaximum 1000 characters
​
size
string
default:"1:1"
Image aspect ratioSupported aspect ratios:
  • 1:1 - Square (default)
  • 4:3 - Landscape 4:3
  • 3:4 - Portrait 3:4
  • 16:9 - Landscape widescreen
  • 9:16 - Portrait vertical
  • 3:2 - Landscape 3:2
  • 2:3 - Portrait 2:3
  • 21:9 - Ultra-wide
  • 9:21 - Ultra-tall
  • auto - Auto-match reference image ratio (requires image_urls)
​
n
integer
default:1
Number of images to generateRange: 1-15 (minimum 1, maximum 15)Default: 1Note:
  • The actual number of images that can be generated is affected by both this parameter and the number of input reference images. The total of reference images + generated images must be ≤ 15
  • Must enter a plain number (e.g., 1), do not use quotes or it will cause an error
Charges will be pre-deducted based on the number
​
image_urls
string[]
Reference image URL list for image-to-image or image editing⚠️ URL format only (base64 no longer supported)
  • Publicly accessible image URL (http:// or https://)
  • Example: https://example.com/image.jpg
  • You can use the Upload Image API to upload local images and get URLs
Limitations:
  • Maximum 10 images
  • Image formats: jpeg, png
  • Aspect ratio (width/height) range: [1/3, 3]
  • Width and height (px) > 14
  • Single image size: not exceeding 10MB
  • Total pixels: not exceeding 6000×6000 px
​
metadata
object
Channel-specific parameters for Seedream 4.0 model advanced configuration

​
Response

​
id
string
Unique task identifier for status queries
​
object
string
Object type, always generation.task
​
model
string
Model name used
​
status
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
​
progress
integer
Task progress percentage (0-100)
​
created_at
integer
Task creation timestamp (Unix timestamp)
​
metadata
object
Task metadata
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-4-0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "n": 1,
    "metadata": {
      "resolution": "2K"
    }
  }'

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "doubao-seedream-4-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}