Get API Key Get API
Docs

Seedream-5.0-Lite Image Generation

- Asynchronous processing mode, returns task ID for subsequent queries

  • Supports multiple generation modes including text-to-image, image-to-image, and sequential image generation
  • Supports 2K / 3K resolution with PNG / JPEG output formats
  • Generated image links are valid for 72 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-5-0-lite",
    "prompt": "A golden retriever playing in a garden, sunny day, high-definition photography style",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

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-5-0-lite, seedream-5.0-lite, Seedream-5.0-lite

Example: "seedream-5-0-lite"

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

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
  • 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.

Note: Seedream-5.0-Lite does not support 9:21 ratio

resolution string

Image resolution

Supported resolutions:

  • 2K - Standard resolution (default)
  • 3K - High definition
  • 4K - Ultra high definition

Note: Seedream-5.0-Lite supports 2K, 3K, and 4K resolutions, and does not support 1K

Resolution reference sizes:

Resolution 1:1 Size 16:9 Size 2:1 Size 1:2 Size
2K 2048x2048 2848x1600 2880x1440 1440x2880
3K 3072x3072 4096x2304 4320x2160 2160x4320
4K 4096x4096 5504x3040 5760x2880 2880x5760
**2K Resolution**

| Ratio | Pixels |
| - | - |
| 1:1 | 2048×2048 |
| 4:3 | 2304×1728 |
| 3:4 | 1728×2304 |
| 16:9 | 2848×1600 |
| 9:16 | 1600×2848 |
| 3:2 | 2496×1664 |
| 2:3 | 1664×2496 |
| 2:1 | 2880×1440 |
| 1:2 | 1440×2880 |
| 21:9 | 3136×1344 |

**3K Resolution**

| Ratio | Pixels |
| - | - |
| 1:1 | 3072×3072 |
| 4:3 | 3456×2592 |
| 3:4 | 2592×3456 |
| 16:9 | 4096×2304 |
| 9:16 | 2304×4096 |
| 3:2 | 3744×2496 |
| 2:3 | 2496×3744 |
| 2:1 | 4320×2160 |
| 1:2 | 2160×4320 |
| 21:9 | 4704×2016 |

**4K Resolution**

| Ratio | Pixels |
| - | - |
| 1:1 | 4096×4096 |
| 4:3 | 4704×3520 |
| 3:4 | 3520×4704 |
| 16:9 | 5504×3040 |
| 9:16 | 3040×5504 |
| 3:2 | 4992×3328 |
| 2:3 | 3328×4992 |
| 2:1 | 5760×2880 |
| 1:2 | 2880×5760 |
| 21:9 | 6240×2656 |
n integer

Number of images to generate

Range: 1-15

Default: 1

Note:

  • When n > 1, sequential image generation mode is automatically enabled
  • 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 generation

Two formats are 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 full Data URI format
  • Format: data:image/{format};base64,{base64data}
  • Supported image formats: jpeg, png
  • Example: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Note: Must include the data:image/jpeg;base64, prefix

Limitations:

  • Image formats: jpeg, png
  • Aspect ratio (width/height) range: [1/3, 3]
  • Width and height (px) > 14
  • Size: not exceeding 10MB per image
  • 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.

output_format string

Output image format

  • jpeg: JPEG format (default)
  • png: PNG format, suitable for transparent backgrounds and similar use cases

Note: The output_format parameter is exclusive to Seedream-5.0-Lite. Other image models will ignore this parameter.

sequential_image_generation string

Sequential image generation mode

Controls whether to generate multiple images:

  • disabled: Disable sequential mode (default)
  • auto: Enable sequential mode, can generate multiple images

Usage Notes:

  • When n > 1, it will automatically be set to auto
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

Example:

"sequential_image_generation": "auto",
"sequential_image_generation_options": {
  "max_images": 4
}
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.