Seedream 5.0 Pro API
最高 4K 的高细节图片。
- 标准20 积分/张 ($0.10)比 fal 便宜 25% fal 价格 $0.135/张

价格
价格自 2026-11-09 起生效
| 档位 | 价格 |
|---|---|
标准 standard | 20 积分/张 ($0.10)注 1 |
- 输入图片超出 1 张后,每张 1 积分。
1 积分 ≈ $0.005。按标准充值包计算;较大的充值包含赠送积分,实际单价更低。
交付与计费
- 成品
- 成品文件列在任务结果中,每个文件有素材 ID 和类型。
- 下载
- 文件保存 7 天,通过短期签名链接下载,可随时删除。
- 计费
- 任务受理时冻结积分,交付后扣费。生成失败,或 24 小时内未交付,冻结的积分会全部释放。
- 通知
- 按任务 ID 轮询,或使用签名 Webhook,并按 event_id 去重。
如何计费?
API 参考
任务只创建一次,之后按 ID 查询。 完整脚本(含上传和下载) · API 文档
API=https://api.vizoapi.com/v1
AUTH="Authorization: Bearer $VIZO_API_KEY"
# Create the task once and keep its ID.
ID=$(curl -fsS $API/generations -H "$AUTH" -H "Content-Type: application/json" \
-d '{
"model": "seedream-5-0-pro",
"input": {
"prompt": "电影感广角剧照。一名身穿白色宇航服的宇航员站在浅灰色的月面平原上,仰头望向低悬在漆黑天空中的巨大深灰色环形空间站,视角略微仰视。圆环没有闭合:一侧有一道清晰的缺口。一颗小小的琥珀色行星在圆环中央发光。空间站的装甲面板和一排细小的灯光与参考图一致。低角度硬光,长长的影子,细腻的胶片颗粒。没有文字,没有字母。"
},
"metadata": {
"client_reference": "my-unique-reference-1"
}
}' | jq -r .id)
# Poll until the task closes, then read its status and result.
until curl -fsS $API/generations/$ID -H "$AUTH" | jq -e '.closed_at != null' > /dev/null; do sleep 5; done
curl -fsS $API/generations/$ID -H "$AUTH" | jq '{status, result}'全部字段
在 input 中发送这些字段。表中没有的字段会被拒绝,返回 HTTP 422 invalid_input。
optimize_prompt_optionsis allowed only withoptimize_promptset totrue.
| 字段 | 说明 |
|---|---|
| Text prompt. Must not be blank. |
| Random seed; -1 picks one at random. 最小 -1 · 最大 9223372036854775807 |
| Output size: WIDTHxHEIGHT with 3,686,400 to 10,404,496 pixels in total, or 2k or 3k. 格式 |
| Reference images, up to 10. 最多 10 项 |
| Rewrites the prompt before generation. 默认值 |
| Allowed only with optimize_prompt set to true. |
optimize_prompt_options. | Prompt expansion. 可选值 autoenableddisabled |
optimize_prompt_options. | Optimization mode. Only standard. 固定值 |
| Image file format. Seedream 5.0 Pro returns JPEG only. 可选值 jpeg默认值 |
| Add a visible watermark. Defaults to false; the tier price is unchanged. 默认值 |
完整请求与响应示例
完整的创建请求、202 响应,以及任务成功后的状态。 此输入选择 standard 档位,每张 20 积分。一张图片冻结 20.000 积分。
请求
{
"model": "seedream-5-0-pro",
"input": {
"prompt": "A paper boat on a pond at dawn, soft watercolor"
},
"metadata": {
"client_reference": "my-unique-reference-1"
}
}202 已受理
{
"id": "gen_01JD8Z5QW3XR",
"model": "seedream-5-0-pro",
"source": "api",
"created_at": "2026-11-08T09:00:00Z",
"customer_resolution_deadline": "2026-11-09T09:00:00Z",
"late_result_available": false,
"metadata": {
"client_reference": "my-unique-reference-1"
},
"status": "processing",
"execution_status": "processing",
"delivery_status": "pending",
"billing_status": "pending",
"version": 1,
"price": {
"unit": "credit",
"estimated": "20.000",
"reserved": "0.000",
"charged": "0.000",
"refunded": "0.000"
},
"allowed_actions": [],
"closed_at": null,
"error": null,
"result": null
}200 已成功
{
"id": "gen_01JD8Z5QW3XR",
"model": "seedream-5-0-pro",
"source": "api",
"created_at": "2026-11-08T09:00:00Z",
"customer_resolution_deadline": "2026-11-09T09:00:00Z",
"late_result_available": false,
"metadata": {
"client_reference": "my-unique-reference-1"
},
"status": "succeeded",
"execution_status": "succeeded",
"delivery_status": "ready",
"billing_status": "settled",
"version": 4,
"price": {
"unit": "credit",
"estimated": "20.000",
"reserved": "0.000",
"charged": "20.000",
"refunded": "0.000"
},
"allowed_actions": [],
"closed_at": "2026-11-08T09:01:31Z",
"error": null,
"result": {
"asset_id": "ast_01JD8Z9M2C4V",
"outputs": [
{
"index": 0,
"asset_id": "ast_01JD8Z9M2C4V",
"content_type": "image/jpeg"
}
]
}
}