Pro 和 Flash 均支持文生图、图生图、多图融合、图层拆分及交互编辑。Flash 不支持快速提示词优化,Pro 的 1.5K 和 2K 促销价分别列出。
在 TTAPI 上调用 Seedream 5.0
TTAPI 新增 doubao-seedream-5-0-pro-260628 和 doubao-seedream-5-0-flash-260915,分别在 Seedream 模型页列出。请求的 model 字段应填完整 ID。
Seedream 5.0 Pro 的官方展示侧重密集信息图、交互编辑、摄影质感、多语言生成和风格变化。TTAPI 模型页分别标注了 Pro 与 Flash 的来源。
文生图、参考图、多图融合与编辑
异步接口 POST /sd/api/v3/images/generations/tasks 接收 model 和 prompt;用 image 传一张参考图进行图生图或编辑,传两到十张图进行融合。图层拆分和交互编辑另有文档,可在提示词中描述待拆分的图层或标注区域。
同步接口 POST /sd/api/v3/images/generations 直接返回图像。生成支持 1K、1.5K、默认 2K 或明确的像素尺寸。图层拆分默认 auto,支持 1K、1.5K、2K,无像素尺寸选项,返回 PNG。optimize_prompt_options.mode 默认 standard,Flash 不支持 fast。异步流程另有 execution_expires_after、priority 和 safety_identifier,文档未列出回调字段。
| 操作方式 | 接口 | 必填输入 | 适用场景 |
|---|---|---|---|
| 文生图(异步) | POST /sd/api/v3/images/generations/tasks | model + prompt | 排队生成,返回任务 ID |
| 文生图(同步) | POST /sd/api/v3/images/generations | model + prompt | 直接返回图像 |
| 图生图 | POST /sd/api/v3/images/generations/tasks | model + prompt + image | 编辑一张参考图 |
| 多图输入 | POST /sd/api/v3/images/generations/tasks | model + prompt + 2 至 10 张参考图 | 融合与合成 |
| 图层拆分 | POST /sd/api/v3/images/generations/tasks | model + prompt + image + layer_decomposition | 最多拆分为 16 个图层 |
| 交互式编辑 | POST /sd/api/v3/images/generations/tasks | model + prompt + image | 按坐标和标记编辑 |
提交和查询生成任务
异步请求按 TTAPI 英文 OpenAPI 定义发送。接口返回任务 id,保存后用于轮询;TT-API-KEY 应留在服务端。
以 GET /sd/api/v3/images/generations/tasks/{id} 查询。状态包括 PENDING_QUEUE、ON_QUEUE、SUCCESS 和 FAILED。成功时 data.images 包含图像。response_format 默认 url,下载链接 24 小时有效;也可设为 b64_json 取 Base64。轮询应有停止条件,并处理失败和过期。
curl --request POST \
--url 'https://api.ttapi.io/sd/api/v3/images/generations/tasks' \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "A high-density infographic explaining the six major types of tea, with a watercolor flavor wheel and labeled brewing temperatures.",
"size": "2K",
"output_format": "jpeg",
"response_format": "url",
"watermark": false
}'按模型、分辨率和操作计算价格
文中所列活动期间,Pro 按原价的 70% 计费。1.5K、2K 生成分别为 3.15、6.3 quota,图层拆分分别为 1.575、3.15 quota。输入图像每张 0.21 quota,Flash 每张 1.8 quota。
批量估价前请核对价格页,区分图像生成、图层拆分和输入图。官方样例用于展示效果。
| 模型 / 操作 | 规格 | 优惠价 | 原价 |
|---|---|---|---|
| doubao-seedream-5-0-pro | 1.5K | 3.15 quota | 4.5 quota |
| doubao-seedream-5-0-pro | 2K | 6.3 quota | 9 quota |
| doubao-seedream-5-0-pro | 图层拆分 1.5K | 1.575 quota | 2.25 quota |
| doubao-seedream-5-0-pro | 图层拆分 2K | 3.15 quota | 4.5 quota |
| doubao-seedream-5-0-pro | 输入 | 0.21 quota | 0.3 quota |
| doubao-seedream-5-0-flash | — | — | 1.8 quota |
curl --request POST \
--url 'https://api.ttapi.io/sd/api/v3/images/generations' \
--header "TT-API-KEY: $TTAPI_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0-pro-260628",
"prompt": "A clean editorial poster about the six major types of tea, with readable labels and a watercolor flavor wheel.",
"size": "2K",
"output_format": "jpeg",
"response_format": "url",
"background": "opaque",
"watermark": false
}'