Skip to main content
POST

Authorizations

string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Body

string
default:"doubao-seedance-4-5"
required
Image generation model nameSupported models: doubao-seedance-4-5, Doubao-Seedream-4.5, doubao-seedream-4.5, doubao-seedream-4-5Example: "doubao-seedance-4-5"
string
required
Text description for image generation
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 aspect ratio (requires image_urls)
string
default:"2K"
Image resolutionSupported resolutions:
  • 2K - Standard resolution (default)
  • 4K - High definition
Note: Seedream-4.5 does not support 1K resolution
Resolution reference sizes:
integer
Number of images to generateRange: 1-15 (minimum 1, maximum 15)Default: 1Note:
  • 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
The number of reference images in image_urls + the final number of images specified by n must be ≤ 15.
array
Reference image URL list for image-to-image or image editingTwo formats are supported:1. Complete image URL
  • Publicly accessible image URL (http:// or https://)
  • Example: https://example.com/image.jpg
2. Base64 encoded format
  • Must use the complete Data URI format
  • Format: data:image/{format};base64,{base64 data}
  • Supported image formats: jpeg, png
  • Example: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • Note: the data:image/jpeg;base64, prefix is required
Limits:
  • Image formats: jpeg, png
  • Aspect ratio (width/height) range: [1/3, 3]
  • Width and height (px) > 14
  • Size: not exceeding 10MB
  • Total pixels: not exceeding 6000×6000 px
The number of reference images in image_urls + the final number of images specified by n must be ≤ 15.
string
default:"standard"
Prompt optimization mode
  • standard: Standard mode, generates higher quality content with longer processing time
  • fast: Fast mode, generates content in shorter time with regular quality
Default: standard
string
default:"disabled"
Sequential image generation mode (Doubao-specific feature)Controls whether to generate multiple images:
  • disabled: Disable sequential mode, generates only 1 image even with multiple reference images (default)
  • auto: Enable sequential mode, can generate multiple images
Usage Notes:
  • ✅ Must provide image_urls - at least 1 reference image required
  • ✅ Set n: 3 or use sequential_image_generation: "auto" + max_images: 3
  • ✅ This will generate 3 different images based on reference images
  • ⚠️ When n > 1, it will automatically be set to auto
Limitations:
  • Pure text-to-image (without image_urls) cannot generate multiple images - this is a Doubao API limitation
object
Sequential image generation optionsAvailable when sequential_image_generation is set to autoProperties:
  • max_images (integer): Specify the number of images to generate, Range: 1-15
Example:
boolean
default:"false"
Whether to add a watermark to the generated image
  • true: Add watermark
  • false: No watermark (default)

Response

integer
Response status code
array
Response data array