跳转到主要内容
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"