Skip to main content
POST
/
generate
/
vol
/
seedream-single
Seedream Single Image Generation
curl --request POST \
  --url https://api.sinancode.com/v1/generate/vol/seedream-single \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "把这张照片变成黏土风格。放在一张拍立得照片中...",
  "images": [
    "https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"
  ],
  "resolution": "",
  "size": "2K",
  "version": "4.5"
}
'
{
  "task_id": "01234567-89ab-cdef-0123-456789abcdef"
}
Generate a single high-quality image using ByteDance’s Seedream 4.0 / Seedream 4.5 model. Key Features:
  • Single Output - Generate one high-quality image per request
  • Dual Version Support - Support both Seedream 4.0 and Seedream 4.5 models
  • 4K Ultra HD - Support high resolution output with automatic optimal aspect ratio selection
  • Multiple Artistic Styles - Freely switch and blend artistic styles
  • Ultra-Fast Generation - High-performance architecture for fast generation

Authorizations

​
Authorization
string
header
required

Please use your API Token for authentication

Body

application/json

Task parameters

​
prompt
string
required

Prompt (required, recommended max 300 Chinese characters or 600 English words)

Required string length: 1 - 2000
Example:

"把这张照片变成黏土风格。放在一张拍立得照片中..."

​
images
string[]

Input images (optional, supports multiple reference images, max 14) Example: ["https://example.com/1.jpg", "https://example.com/2.jpg"]

Example:
[
  "https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"
]
​
resolution
string

Exact resolution (optional, overrides Size) Format: widthxheight, e.g., "2048x2048", "2560x1440" Total pixels range: [3686400, 16777216], aspect ratio range: [1/16, 16]

Example:

""

​
size
enum<string>
default:2K

Size tier (optional, default 2K) Options: 2K, 4K When using this field, describe aspect ratio in prompt, model auto-determines image size

Available options:
2K,
4K
Example:

"2K"

​
version
enum<string>
default:4.5

Model version (optional, default 4.5) Options: 4.0, 4.5

Available options:
4.0,
4.5
Example:

"4.5"

Response

OK

​
task_id
string
required

Task ID

Example:

"01234567-89ab-cdef-0123-456789abcdef"