Seedream 5.0 Lite Image Generation

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.0-lite",
  "prompt": "A paper boat on a quiet lake at sunset",
  "size": "3:4",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5lite",
  "model": "doubao-seedream-5.0-lite",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.0-lite",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.0-lite",
  "prompt": "A paper boat on a quiet lake at sunset",
  "size": "3:4",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5lite",
  "model": "doubao-seedream-5.0-lite",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.0-lite",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Authorizations

Authorization

string

header

required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

default:doubao-seedream-5.0-lite

required

Image generation model name

Available options:

doubao-seedream-5.0-lite

Example:

"doubao-seedream-5.0-lite"

prompt

string

required

Prompt describing the image you want to generate, or describing how to edit the input image, limited to 2000 tokens

Maximum string length: 2000

Example:

"A serene lake reflecting the beautiful sunset"

integer

Maximum number of images to generate, supports any integer value between [1,15]

Note:

To generate multiple images, include prompts like: "generate 2 different images" in your prompt
Reference image count + final generated image count ≤ 15 images
If: reference image count + images requested in prompt > 15, and images requested in prompt ≤ parameter n value, then final generated images = 15 - reference image count
Each request will pre-charge based on the value of n, actual charges based on the number of images generated

Example:

1

size

string

default:auto

Size of generated image, supports two formats:

Method 1 - Ratio format:

auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21
Works with the quality parameter to automatically generate an image at the corresponding aspect ratio and resolution, without manually specifying pixels

Method 2 - Pixel format:

Width x height, e.g.: 2560x1440, 2048x2048, 4096x4096
Total pixel range: [3686400, 16777216]
Aspect ratio range: [1/16, 16]

Example:

"16:9"

quality

enum<string>

default:2K

Resolution tier, used with the ratio format of size.

Aspect ratio	2K	3K	4K
`1:1`	2048×2048	3072×3072	4096×4096
`2:3`	1664×2496	2496×3744	3328×4992
`3:2`	2496×1664	3744×2496	4992×3328
`3:4`	1728×2304	2592×3456	3520×4704
`4:3`	2304×1728	3456×2592	4704×3520
`4:5`	1792×2240	2688×3360	3584×4480
`5:4`	2240×1792	3360×2688	4480×3584
`9:16`	1600×2848	2304×4096	3040×5504
`16:9`	2848×1600	4096×2304	5504×3040
`21:9`	3136×1344	4704×2016	6240×2656
`9:21`	1344×3136	2016×4704	2656×6240

Available options:

2K,

3K,

4K

Example:

"2K"

prompt_priority

enum<string>

default:standard

Prompt optimization strategy, used to set the mode for prompt optimization

Options:

standard: Standard mode, higher quality output, longer processing time

Available options:

standard

Example:

"standard"

image_urls

string<uri>[]

Reference image URL list for image-to-image and image editing features

Note:

Single request supports input image quantity: 14 images
Image size: no more than 10MB
Supported image formats: .jpeg, .jpg, .png, .webp, .bmp, .tiff, .gif
Aspect ratio (width/height) range: [1/16, 16]
Width and height (px) > 14
Total pixels: no more than 6000×6000
Image URLs must be directly viewable by the server, or the image URL should trigger direct download when accessed (typically these URLs end with image file extensions, such as .png, .jpg)

Maximum array length: 14

Example:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

model_params

object

Supported parameters:

output_format: Output image format
tools: Web search tool

Show child attributes

callback_url

string<uri>

HTTPS callback address after task completion

Callback Timing:

Triggered when task is completed, failed, or cancelled
Sent after billing confirmation is completed

Security Restrictions:

Only HTTPS protocol is supported
Callback to internal IP addresses is prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback Mechanism:

Timeout: 10 seconds
Maximum 3 retries on failure (retries after 1 second/2 seconds/4 seconds)
Callback response body format is consistent with the task query API response format
Callback address returning 2xx status code is considered successful, other status codes will trigger retry

Example:

"https://your-domain.com/webhooks/image-task-completed"

Response

Image generation task created successfully

created

integer

Task creation timestamp

Example:

1757165031

string

Task ID

Example:

"task-unified-1757165031-seedream5lite"

model

string

Actual model name used

Example:

"doubao-seedream-5.0-lite"

object

enum<string>

Specific task type

Available options:

image.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Async task information

Show child attributes

type

enum<string>

Task output type

Available options:

text,

image,

audio,

video

Example:

"image"

usage

object

Usage and billing information

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Seedream 5.0 Lite Image Generation

Authorizations

Body

Response