Seedream 图像生成

Seedream 是字节跳动豆包系的图像生成模型，支持文生图、高分辨率输出与精细提示词（含中文文字渲染），通过 OpenAI 兼容图像接口调用，同步返回结果。

端点

POST $URL/v1/images/generations

使用 OpenAI SDK 时，base_url 设为 $URL/v1 即可。

支持模型

模型	定位
dola-seedream-5.0-pro	专业版，质量最高，支持 1.5K 以下 / 以上双档分辨率
seedream-5.0-lite	轻量版，性价比高

主要参数

参数	类型	必填	说明
model	string	是	上表中的模型名
prompt	string	是	图片描述，建议包含主体、风格、文字内容
n	integer	否	生成数量，默认 1。当前每次请求返回 1 张：传入更大值不会报错，实际仍只返回 1 张
size	string	否	输出尺寸，如 1024x1024、1536x1536、2048x2048。seedream-5.0-lite 最小 1920x1920（总像素 ≥ 3,686,400），更小会返回 400
seed	integer	否	随机种子，相同种子与提示词可复现相近结果
response_format	string	否	url（默认，临时链接）/ b64_json
quality	string	否	输出质量等级，支持范围取决于模型
style	string	否	图片风格，支持范围取决于模型
background	string	否	背景模式（如透明背景），仅部分模型支持
output_format	string	否	输出文件格式（如 jpeg / png），仅部分模型支持
watermark	boolean	否	是否添加水印

请求示例

curl

curl $URL/v1/images/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedream-5.0-pro",
    "prompt": "一张科技感十足的产品海报，中央是一款无线耳机，背景为深蓝色渐变，底部白色粗体字：FUTURE SOUND",
    "n": 1,
    "size": "2048x2048"
  }'

Python

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="$URL/v1")
resp = client.images.generate(
    model="seedream-5.0-lite",
    prompt="一张科技感十足的产品海报，中央是一款无线耳机，背景为深蓝色渐变",
    n=1,
    size="2048x2048",
    seed=42,
)
print(resp.data[0].url)

响应字段

字段	类型	说明
created	integer	创建时间戳（秒）
model	string	实际处理请求的模型编码（厂商规范化名，如 seedream-5-0-260128）
data	array	生成结果列表（当前为 1 张）
data[].url	string	图片临时访问地址（请尽快下载保存）
data[].size	string	实际生成尺寸，如 2048x2048
data[].b64_json	string	图片 base64 内容（response_format: "b64_json" 时返回）
usage.generated_images	integer	实际成功生成的图片张数
usage.output_tokens	integer	图片生成消耗的输出 Token 数（仅计量展示，不参与计费）

响应示例

{
  "model": "seedream-5-0-260128",
  "created": 1791869249,
  "data": [
    {
      "url": "https://.../seedream-5-0/xxxx.jpeg",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}

计费

按每张输出图计费，dola-seedream-5.0-pro 按分辨率分档：

模型	≤1.5K（≤261万像素）	>1.5K	输入参考图
dola-seedream-5.0-pro	$0.045/张	$0.09/张	第 1 张免费，第 2 张起 $0.003/张
seedream-5.0-lite	$0.035/张	$0.035/张	—

计费示例：dola-seedream-5.0-pro 生成 1 张 2048x2048（约 419 万像素，落入 >1.5K 档）= $0.09；1536x1536（约 236 万像素）= $0.045。

说明

• 结果 URL 为临时链接，请尽快下载保存（可用 response_format: "b64_json" 直接取 base64）。
• Seedream 对中文提示词与文字渲染支持良好，适合海报、封面、电商主图。
• 不要依赖 n 生成多张：需要多张时请并发多次请求。
• seedream-5.0-lite 有尺寸下限（1920x1920），dola-seedream-5.0-pro 从 1024x1024 起即可。
• 分组倍率另计，以上单价为基准货币价。