Seedream 5 Pro API 指南

用于 AI 图片生成的 Seedream 5 Pro API

Seedream 5 Pro 是字节跳动旗舰图像模型——多语言图上文字渲染出色、支持多参考图编辑、写实输出干净。在 Seedance API 上以稳定别名调用:REST 接口、异步任务轮询、按图计费。

分辨率
1K / 2K

1K 或 2K 输出

宽高比
7

1:1 至 16:9、9:16、2:3、3:2

输入
T2I + I2I

提示词或最多 10 张参考图

接口
REST

HTTPS JSON

入门请求

创建 Seedream 5 Pro 图片任务

seedream-5-pro
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。

为什么接入 Seedream 5 Pro API

当团队需要旗舰画质、又不想处理供应商 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。

Seedream 5 Pro API 能力

公开接口覆盖模型的真实能力:文生图与最多十张参考图的编辑。

文生图

发送最长 3000 字符的提示词,加上宽高比与分辨率,模型自动处理构图、光线与图上文字。

多参考图编辑

在 image_urls 传入 1–10 个公开 HTTPS 图片 URL,即可编辑、合成或重风格化现有视觉——产品替换、换背景、风格迁移。

2K 高分辨率输出

resolution 设为 "2k" 可获得印刷级成品图;1K 适合预览与快速迭代。

多语言图上文字

Seedream 5 Pro 的强项之一——海报、标牌中的中英日等多语言文字清晰可读。

异步任务架构

创建即返回 task_id,按节奏轮询状态,UI 保持响应——不需要长连接。

与供应商无关的响应

无论上游如何路由,响应结构保持稳定;consumed_credits、status、图片 URL 都已归一化。

如何调用 Seedream 5 Pro API

从 API 密钥到图片 URL,只需三步。

1

创建 API 密钥

登录后打开 API Keys 页面,复制用于服务端调用的密钥——放在后端,别进浏览器代码。

2

提交生成任务

调用 POST /v1/images/generations,传 model "seedream-5-pro"、prompt、aspect_ratio、resolution 与可选 image_urls,返回 task_id 与 estimated_credits。

3

轮询并渲染

调用 GET /v1/images/generations/:task_id,status 为 SUCCESS 时读取 images[0].url,展示或存档。

接口参考

两个接口覆盖完整生命周期——创建与轮询。

POST /v1/images/generations

创建 Seedream 5 Pro 任务。image_urls 为空即文生图,传 1–10 个 URL 即参考图编辑。返回 202 与 task_id、estimated_credits。

GET /v1/images/generations/:task_id

返回 IN_PROGRESS、含 images[].url 的 SUCCESS,或带 error 的 FAILED。完成后会给出 consumed_credits。

错误与限流

400 参数错误、401 密钥无效、402 积分不足、404 任务不存在、429 限流、503 上游不可用。完整表见文档。

请求参数

参数取值
model必须为 "seedream-5-pro"——此路由唯一的公开模型。
prompt提示词或编辑指令,1–3000 字符。
aspect_ratio1:1、4:3、3:4、16:9、9:16、2:3、3:2 之一,默认 1:1。
resolution"1k"(默认,9 积分)或 "2k"(18 积分)。
image_urls0–10 个公开 HTTPS URL,空数组即纯文生图。

未知参数会以 400 UNKNOWN_PARAMETER 拒绝——契约保持显式。完整 schema 见 /docs/images。

积分计费

按图计费,使用 Seedance API 积分。创建响应含 estimated_credits,完成状态返回 consumed_credits。

模式积分说明
文生图 · 1K9 积分 / 张默认分辨率,适合迭代与预览。
文生图 · 2K18 积分 / 张印刷级成品输出。
参考图编辑每张额外参考图 +0.8 积分首张参考图含在基础价内,第 2–10 张每张 +0.8。

Seedream 5 Pro API 常见问题

面向评估 Seedance API 上 Seedream 5 Pro API 的开发者。

这是字节跳动官方的 Seedream 5 Pro API 吗?

Seedance API 将 Seedream 5 Pro 封装在稳定的 REST 面之后——你获得模型完整能力,鉴权、计费、响应均已归一化,无需自己管理供应商凭据。

文生图和参考图编辑有什么区别?

image_urls 传空数组即文生图;传 1–10 个公开 HTTPS 图片 URL 即参考图编辑或合成——同一接口处理两种模式。

Seedream 5 Pro 支持哪些宽高比?

1:1、4:3、3:4、16:9、9:16、2:3、3:2。选择匹配投放位置的比例——模型按该比例原生构图,而非裁切。

Seedream 5 Pro 一张图多少钱?

1K 每张 9 积分,2K 每张 18 积分;参考图编辑第 2 张起每张 +0.8。创建响应返回 estimated_credits,可在轮询前确认成本。

一次生成要多久?

1K 任务通常 15–25 秒完成;2K 与多参考编辑更久。轮询状态接口即可——任务本就是异步设计。

可以从浏览器直接调这个 API 吗?

不行,也不应该。Bearer 密钥放在后端,服务端调用我们的接口,只向客户端暴露你自己的安全路由。

Seedream 5 Pro 能在图里渲染文字吗?

能——多语言图上文字是它的强项。海报、价签、本地化广告图里的中英日等文字清晰可读。

完整 API 文档在哪里?

完整请求 schema、响应示例、错误表与计费说明在 /docs/images。本页是集成概览。

创建你的第一张 Seedream 5 Pro 图片

获取 API 密钥,提交第一个生成任务,今天就把旗舰级图片生成接入你的产品。