Skip to main content
POST
/
v1
/
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": "Generate an illustration of the latest fashion trends from Paris Fashion Week 2025",
  "size": "3:4",
  "quality": "2K",
  "model_params": {
    "tools": [
      {
        "type": "web_search"
      }
    ]
  }
}
'
{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5lite",
  "model": "doubao-seedream-5.0-lite",
  "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt

Use this file to discover all available pages before exploring further.

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"

​
n
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

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
  • Works with quality parameter to automatically generate images at the specified ratio and resolution, no need to specify exact pixels

Method 2 - Pixel format:

  • Width x Height, e.g.: 2560x1440, 2048x2048, 3072x3072 and other values within range
  • Default: 2048x2048
  • Total pixel range: [2560x1440, 3072x3072]
  • Aspect ratio range: [1/16, 16]
Example:

"16:9"

​
quality
enum<string>

Resolution tier, used in combination with ratio format of size

Options:

  • 2K: 2K resolution
  • 3K: 3K resolution

Works with ratio format of size to automatically generate images at the corresponding resolution

Available options:
2K,
3K
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
​
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

​
id
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

​
type
enum<string>

Task output type

Available options:
text,
image,
audio,
video
Example:

"image"

​
usage
object

Usage and billing information