Get API Key Get API
Docs

Seedream-4.0 Image Generation

- Asynchronous processing mode, returns task ID for subsequent queries

  • Supports multiple generation modes including text-to-image, image-to-image, and image editing
  • Generated image links are valid for 24 hours, please save them promptly

Request example

curl --request POST \
  --url https://api.openveer.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedream-4.0",
    "prompt": "A cute panda playing in a bamboo forest",
    "size": "1:1",
    "resolution": "2K",
    "n": 1,
    "image_urls": [
      "https://cdn.openveer.com/doc/1761215838466614297_9852.png"
    ]
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

model string

Image generation model name

Supported models: seedream-4.0, seedream-4-0, Seedream-4.0

Example: "seedream-4.0"

nsfw_check boolean

Whether to run content moderation before submitting the image task.

  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
prompt string

Text description for image generation

Maximum 1000 characters

size string

Image aspect ratio

Supported 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
  • 2:1 - Extra-wide landscape
  • 1:2 - Extra-tall portrait
  • 21:9 - Ultra-wide
  • 9:21 - Ultra-tall
  • auto - Auto-match reference image aspect ratio (requires image_urls)

2x1 is equivalent to 2:1, and 1x2 is equivalent to 1:2. The x must be lowercase and spaces are not allowed.

resolution string

Image resolution

Supported resolutions:

  • 1K - Basic resolution
  • 2K - Standard resolution (default)
  • 4K - High definition

Resolution reference sizes:

Resolution 1:1 Size 16:9 Size 2:1 Size 1:2 Size
1K 1024x1024 1280x720 1440x720 720x1440
2K 2048x2048 2560x1440 2880x1440 1440x2880
4K 4096x4096 5404x3040 5760x2880 2880x5760
**1K Resolution**

| Ratio | Pixels |
| - | - |
| 1:1 | 1024x1024 |
| 4:3 | 1152x864 |
| 3:4 | 864x1152 |
| 16:9 | 1280x720 |
| 9:16 | 720x1280 |
| 3:2 | 1248x832 |
| 2:3 | 832x1248 |
| 2:1 | 1440x720 |
| 1:2 | 720x1440 |
| 21:9 | 1512x648 |
| 9:21 | 648x1512 |

**2K Resolution**

| Ratio | Pixels |
| - | - |
| 1:1 | 2048x2048 |
| 4:3 | 2304x1728 |
| 3:4 | 1728x2304 |
| 16:9 | 2560x1440 |
| 9:16 | 1440x2560 |
| 3:2 | 2496x1664 |
| 2:3 | 1664x2496 |
| 2:1 | 2880x1440 |
| 1:2 | 1440x2880 |
| 21:9 | 3024x1296 |
| 9:21 | 1296x3024 |

**4K Resolution**

| Ratio | Pixels |
| - | - |
| 1:1 | 4096x4096 |
| 4:3 | 4694x3520 |
| 3:4 | 3520x4694 |
| 16:9 | 5404x3040 |
| 9:16 | 3040x5404 |
| 3:2 | 4992x3328 |
| 2:3 | 3328x4992 |
| 2:1 | 5760x2880 |
| 1:2 | 2880x5760 |
| 21:9 | 6198x2656 |
| 9:21 | 2656x6198 |
n integer

Number of images to generate

Range: 1-15 (minimum 1, maximum 15)

Default: 1

Note:

  • 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

Note

The number of reference images in image_urls + the final number of generated images specified by n must be ≤ 15.

image_urls array

Reference image URL list for image-to-image or image editing

Two formats supported:

1. Full 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: Must include the data:image/jpeg;base64, prefix

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
Note

The number of reference images in image_urls + the final number of generated images specified by n must be ≤ 15.

optimize_prompt_options string

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

sequential_image_generation string

Sequential image generation mode (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
sequential_image_generation_options object

Sequential image generation options

Available when sequential_image_generation is set to auto

Properties:

  • max_images (integer): Specify the number of images to generate, Range: 1-15

Example:

"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 3
}
watermark boolean

Whether to add a watermark to the generated image

  • true: Add watermark
  • false: No watermark (default)

Response

code integer

Response status code

data array
Response data array
status string

Task status

  * submitted - Submitted
task_id string

Unique task identifier

This documentation is built and hosted on Mintlify, a developer documentation platform.