Seedream V5 Lite
Seedream V5 Lite image API reference. Generate and edit high-resolution images with ByteDance's Seedream model. Fast generation via REST API.
Generate Image
POST/v1/images/seedream/v5/lite/generate/
Generate images from a text prompt. Seedream V5 Lite supports named image sizes, batch generation of up to 6 images, reproducible output via seed, and an optional safety checker.
curl -X POST https://api.3daistudio.com/v1/images/seedream/v5/lite/generate/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a photorealistic product shot of a leather watch",
"image_size": "landscape_16_9",
"num_images": 2
}'{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_at": "2026-02-25T12:00:00Z"
}Generate Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Yes | Text description of the image to generate. |
| image_size | string | No | Output size preset. Default: "auto_2K". See size options below. |
| num_images | integer | No | Number of images (1 to 6). Default: 1. Credits multiply accordingly. |
| seed | integer | No | Random seed (0 or higher) for reproducible generation. Omit for a random result. |
| enable_safety_checker | boolean | No | Enable content safety filtering. Default: true. |
Image Size Options
| Value | Description |
|---|---|
| square_hd | High-definition square |
| square | Standard square |
| portrait_4_3 | Portrait 4:3 |
| portrait_16_9 | Portrait 16:9 |
| landscape_4_3 | Landscape 4:3 |
| landscape_16_9 | Landscape 16:9 |
| auto_2K | Automatic layout at 2K resolution (default) |
| auto_3K | Automatic layout at 3K resolution |
Edit Image
POST/v1/images/seedream/v5/lite/edit/
Edit existing images with natural-language instructions. Provide one or more base64-encoded source images and a text prompt describing the desired changes.
curl -X POST https://api.3daistudio.com/v1/images/seedream/v5/lite/edit/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Add a warm sunset lighting to this scene",
"image_urls": ["data:image/png;base64,iVBOR..."],
"image_size": "auto_2K"
}'{
"task_id": "f7e8d9c0-b1a2-3456-7890-abcdef012345",
"created_at": "2026-02-25T12:00:00Z"
}Edit Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Yes | Text instruction describing the edit to apply. |
| image_urls | array | Yes | Array of 1 to 10 base64-encoded source images (data:image/...;base64,...). |
| image_size | string | No | Output size preset. Default: "auto_2K". |
| num_images | integer | No | Number of output images (1 to 6). Default: 1. |
| seed | integer | No | Random seed for reproducible output. Omit for random. |
| enable_safety_checker | boolean | No | Enable content safety filtering. Default: true. |
Checking Status
GET/v1/generation-request/<task_id>/status/
Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains your generated or edited images with download URLs and thumbnails. Results expire after 24 hours.
curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
-H "Authorization: Bearer YOUR_API_KEY"{
"status": "FINISHED",
"progress": 100,
"results": [
{
"asset_url": "https://cdn.3daistudio.com/images/img_001.png",
"asset": "https://storage.3daistudio.com/assets/img_001.png",
"asset_type": "IMAGE",
"thumbnail": "https://storage.3daistudio.com/thumbnails/img_001.png"
}
]
}Credit Costs
Seedream V5 Lite has a flat rate regardless of image size. Credits are calculated as cost per image multiplied by the number of images requested.
| Model | Per Image |
|---|---|
| Seedream V5 Lite | 10 credits |
Processing Times
Image generation typically takes 20–40 seconds per image. Editing takes a similar amount of time. Higher resolution presets (auto_3K) and batch requests (multiple images) may take longer.
Errors
Common errors for Seedream V5 Lite image endpoints.
| Status | Error Code | Description |
|---|---|---|
| 402 | insufficient_credits | Not enough credits. Top up your wallet. |
| 429 | rate_limited | Rate limit exceeded. Wait and retry. |
| 400 | validation_failed | Missing or invalid parameters. |