Seedream 5.0 (豆包)

字节跳动 Seedream 5.0（即梦 5）文本生图模型，支持联网搜索。

字节跳动即梦系列最新闭源模型，细节还原能力进一步提升。支持 2K / 3K 分辨率输出，支持联网搜索获取实时信息以增强生图质量。

文件上传提示:如需使用参考图片，请先通过文件上传接口上传图片获取 URL，再把 URL 放进 image_urls 参数。

调用示例

curl https://cokeapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0",
    "prompt": "一只在京都樱花树下的赛博狐狸,电影质感,Portra 400 胶片",
    "size": "1:1",
    "n": 1,
    "metadata": {
      "resolution": "2K"
    }
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

img = client.images.generate(
    model="doubao-seedream-5-0",
    prompt="一只在京都樱花树下的赛博狐狸,电影质感",
    size="1:1",
    n=1,
    extra_body={
        "metadata": {"resolution": "2K"},
    },
)

for d in img.data:
    print(d.url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const img = await client.images.generate({
  model: "doubao-seedream-5-0",
  prompt: "一只在京都樱花树下的赛博狐狸,电影质感",
  size: "1:1",
  n: 1,
  extra_body: {
    metadata: { resolution: "2K" },
  },
});

img.data.forEach((d) => console.log(d.url));

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	固定为 `doubao-seedream-5-0`
prompt	string	是	—	英文 / 中文均可
size	string	否	1:1	画面比例。支持 `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`, `9:21`
n	int	否	1	一次出图数量，1–15，参考图 + 生成图总数 ≤ 15
metadata	object	否	—	生成元数据，详见下方
image_urls	string[]	否	—	参考图片 URL 列表，用于图生图

metadata 参数

参数	类型	必填	默认值	说明
resolution	string	否	2K	图像分辨率，支持 `2K` / `3K`（不支持 1K 和 4K）
sequential_image_generation	string	否	disabled	顺序图像生成模式（豆包专属）。`disabled`：禁用；`auto`：启用，n > 1 时自动启用
sequential_image_generation_options	object	否	—	顺序图像生成选项，需 `sequential_image_generation: "auto"`
watermark	boolean	否	false	是否添加水印

resolution 分辨率参考尺寸

分辨率	1:1 尺寸	16:9 尺寸
2K	2048×2048	2848×1600
3K	3072×3072	4096×2304

sequential_image_generation_options

参数	类型	必填	说明
max_images	int	是	生成图像数量，1–15，参考图 + 生成图总数 ≤ 15

"sequential_image_generation_options": { "max_images": 3 }

image_urls 参数限制

项目	说明
最大数量	10
格式	JPEG / PNG
大小	每张 ≤ 10MB
分辨率	每张 ≤ 6000×6000px
宽高比	宽/高在 [1/3, 3] 范围内
最小尺寸	宽和高均 > 14px

响应示例

创建成功后立即返回任务状态，后续通过异步任务查询结果:

{
  "id": "img_01HX...",
  "object": "generation.task",
  "status": "queued",
  "created_at": 1718000000,
  "model": "doubao-seedream-5-0",
  "progress": 0
}

计费

按 图片张数 扣费，单价 $0.050 / 张（不区分分辨率档位）。完整实时价目以模型列表页为准，本页价格为 2026-07 快照。失败请求（含上游 502）全额退款，不计费。

错误码

code	type	含义	HTTP
400101	`invalid_param`	参数错误（尺寸不支持等）	400
400401	`insufficient_balance`	余额不足	400
401104	`api_key_invalid`	API Key 无效	401
429101	`rate_limit_exceeded`	RPM 超限	429
429302	`daily_quota_exceeded`	每日调用配额耗尽	429
502201	`upstream_unavailable`	ByteDance 服务暂不可用	502
502203	`no_available_account`	暂无可用账号	502

完整列表见错误码。

注意事项

CDN 图片 URL 24 小时后失效，需长期保存请下载到自有存储。
Seedream 5 支持联网搜索，可在 prompt 中引入实时信息辅助生图。
失败请求（含上游 502）全额返还本次扣费，不计费。

本页目录