跳转到主要内容
POST
/
generate
/
vol
/
seedream
Seedream 图片生成
curl --request POST \
  --url https://api.sinancode.com/v1/generate/vol/seedream \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "把这张照片变成黏土风格。放在一张拍立得照片中...",
  "images": [
    "https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"
  ],
  "max_images": 4,
  "size": "2K",
  "version": "5.0-lite"
}
'
{
  "task_id": "01234567-89ab-cdef-0123-456789abcdef"
}
使用字节跳动的 Seedream 模型生成图片,支持单图和组图模式。 模型特点:
  • 多版本支持 - 支持 5.0-lite(默认)、4.5、4.0 三个版本
  • 灵活输出模式 - 单图(max_images=1)或组图(max_images=2-15
  • 文生图 & 图生图 - 支持从文本描述或参考图片(最多 14 张)生成
  • 高清输出 - 5.0-lite 支持 2K/3K,4.5/4.0 支持 2K/4K,也可指定精确分辨率

授权

Authorization
string
header
必填

请使用您的 API Token 进行认证

请求体

application/json

Task parameters

prompt
string
必填

提示词(必填,建议不超过300个汉字或600个英文单词)

Required string length: 1 - 2000
示例:

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

images
string[]

输入图片(可选,支持多张参考图,最多14张) 示例: ["https://example.com/1.jpg", "https://example.com/2.jpg"]

示例:
[
"https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png"
]
max_images
integer
默认值:1

最大图片数(可选,默认1)

  • 设置为 1:生成单张图片(禁用组图功能)
  • 设置为 2-15:生成组图,最多 N 张(输入图数量+生成数量 ≤ 15)
必填范围: 1 <= x <= 15
示例:

4

size
string
默认值:2K

图片尺寸(可选,默认 2K) 支持两种格式:

  • 档位:2K, 3K(5.0-lite)或 2K, 4K(4.5/4.0),由模型根据 prompt 自动判断宽高比
  • 精确分辨率:宽x高,如 "2048x2048"、"2560x1440"
示例:

"2K"

version
enum<string>
默认值:5.0-lite

模型版本(可选,默认 5.0-lite) 可选值:4.0, 4.5, 5.0-lite

可用选项:
4.0,
4.5,
5.0-lite
示例:

"5.0-lite"

响应

OK

task_id
string
必填

Task ID

示例:

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