旗舰级输出质量
Seedream 5 Pro 能渲染写实场景、editorial 产品图和准确的图上文字,支持 1K/2K——与 GPT Image、NanoBanana 同档。
Seedream 5 Pro API 指南
Seedream 5 Pro 是字节跳动旗舰图像模型——多语言图上文字渲染出色、支持多参考图编辑、写实输出干净。在 Seedance API 上以稳定别名调用:REST 接口、异步任务轮询、按图计费。
1K 或 2K 输出
1:1 至 16:9、9:16、2:3、3:2
提示词或最多 10 张参考图
HTTPS JSON
入门请求
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations 返回 task_id,然后轮询 GET /v1/images/generations/:task_id,直到 status 为 SUCCESS,读取 images[].url。
当团队需要旗舰画质、又不想处理供应商 SDK 和变动的接口结构时,会选择 Seedream 5 Pro API——一个稳定、可预期的 REST 面。
Seedream 5 Pro 能渲染写实场景、editorial 产品图和准确的图上文字,支持 1K/2K——与 GPT Image、NanoBanana 同档。
你只调 model "seedream-5-pro",供应商路由、容量、回退都由我们处理,集成不受上游变动影响。
1K 每张 9 积分、2K 每张 18 积分,第二张起每张参考图 +0.8。创建响应直接返回 estimated_credits。
公开接口覆盖模型的真实能力:文生图与最多十张参考图的编辑。
发送最长 3000 字符的提示词,加上宽高比与分辨率,模型自动处理构图、光线与图上文字。
在 image_urls 传入 1–10 个公开 HTTPS 图片 URL,即可编辑、合成或重风格化现有视觉——产品替换、换背景、风格迁移。
resolution 设为 "2k" 可获得印刷级成品图;1K 适合预览与快速迭代。
Seedream 5 Pro 的强项之一——海报、标牌中的中英日等多语言文字清晰可读。
创建即返回 task_id,按节奏轮询状态,UI 保持响应——不需要长连接。
无论上游如何路由,响应结构保持稳定;consumed_credits、status、图片 URL 都已归一化。
从 API 密钥到图片 URL,只需三步。
登录后打开 API Keys 页面,复制用于服务端调用的密钥——放在后端,别进浏览器代码。
调用 POST /v1/images/generations,传 model "seedream-5-pro"、prompt、aspect_ratio、resolution 与可选 image_urls,返回 task_id 与 estimated_credits。
调用 GET /v1/images/generations/:task_id,status 为 SUCCESS 时读取 images[0].url,展示或存档。
两个接口覆盖完整生命周期——创建与轮询。
创建 Seedream 5 Pro 任务。image_urls 为空即文生图,传 1–10 个 URL 即参考图编辑。返回 202 与 task_id、estimated_credits。
返回 IN_PROGRESS、含 images[].url 的 SUCCESS,或带 error 的 FAILED。完成后会给出 consumed_credits。
400 参数错误、401 密钥无效、402 积分不足、404 任务不存在、429 限流、503 上游不可用。完整表见文档。
| 参数 | 取值 |
|---|---|
| model | 必须为 "seedream-5-pro"——此路由唯一的公开模型。 |
| prompt | 提示词或编辑指令,1–3000 字符。 |
| aspect_ratio | 1:1、4:3、3:4、16:9、9:16、2:3、3:2 之一,默认 1:1。 |
| resolution | "1k"(默认,9 积分)或 "2k"(18 积分)。 |
| image_urls | 0–10 个公开 HTTPS URL,空数组即纯文生图。 |
未知参数会以 400 UNKNOWN_PARAMETER 拒绝——契约保持显式。完整 schema 见 /docs/images。
按图计费,使用 Seedance API 积分。创建响应含 estimated_credits,完成状态返回 consumed_credits。
| 模式 | 积分 | 说明 |
|---|---|---|
| 文生图 · 1K | 9 积分 / 张 | 默认分辨率,适合迭代与预览。 |
| 文生图 · 2K | 18 积分 / 张 | 印刷级成品输出。 |
| 参考图编辑 | 每张额外参考图 +0.8 积分 | 首张参考图含在基础价内,第 2–10 张每张 +0.8。 |
面向评估 Seedance API 上 Seedream 5 Pro API 的开发者。
Seedance API 将 Seedream 5 Pro 封装在稳定的 REST 面之后——你获得模型完整能力,鉴权、计费、响应均已归一化,无需自己管理供应商凭据。
image_urls 传空数组即文生图;传 1–10 个公开 HTTPS 图片 URL 即参考图编辑或合成——同一接口处理两种模式。
1:1、4:3、3:4、16:9、9:16、2:3、3:2。选择匹配投放位置的比例——模型按该比例原生构图,而非裁切。
1K 每张 9 积分,2K 每张 18 积分;参考图编辑第 2 张起每张 +0.8。创建响应返回 estimated_credits,可在轮询前确认成本。
1K 任务通常 15–25 秒完成;2K 与多参考编辑更久。轮询状态接口即可——任务本就是异步设计。
不行,也不应该。Bearer 密钥放在后端,服务端调用我们的接口,只向客户端暴露你自己的安全路由。
能——多语言图上文字是它的强项。海报、价签、本地化广告图里的中英日等文字清晰可读。
完整请求 schema、响应示例、错误表与计费说明在 /docs/images。本页是集成概览。
获取 API 密钥,提交第一个生成任务,今天就把旗舰级图片生成接入你的产品。