图像生成系列
Seedream 4.5 (豆包)
字节跳动 Seedream 4.5(即梦 4.5),文生图与图生图模型。
字节跳动即梦系列中间版本,中文场景理解与细节还原能力进一步提升。支持 2K / 4K 分辨率输出,可通过参考图片进行图生图。
参考图上传提示:生成接口不再接收内联 base64 图片数据。请先使用 文件上传接口 上传图片获取 URL,再把 URL 放进 image_urls。
调用示例
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | — | 固定为 doubao-seedream-4-5 |
| 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 / 4K(不支持 1K) |
| optimize_prompt_options | object | 否 | — | 提示词优化选项 |
| optimize_prompt_options.mode | string | 否 | standard | standard(标准,质量更高)或 fast(快速) |
| sequential_image_generation | string | 否 | disabled | 顺序图像生成模式。disabled:禁用;auto:启用,n > 1 时自动启用 |
| sequential_image_generation_options | object | 否 | — | 顺序图像生成选项,需 sequential_image_generation: "auto" |
| watermark | boolean | 否 | true | 是否添加水印 |
resolution 分辨率参考尺寸
| 分辨率 | 1:1 尺寸 | 16:9 尺寸 |
|---|---|---|
| 2K | 2048×2048 | 2560×1440 |
| 4K | 4096×4096 | 5404×3040 |
sequential_image_generation_options
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| max_images | int | 是 | 生成图像数量,1–15,参考图 + 生成图总数 ≤ 15 |
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-4-5",
"progress": 0
}计费
按 图片张数 扣费,单价 $0.057 / 张(不区分分辨率档位)。完整实时价目以 模型列表页 为准,本页价格为 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 | 上游服务暂不可用 | 502 |
| 502203 | no_available_account | 暂无可用账号 | 502 |
完整列表见 错误码。
注意事项
- CDN 图片 URL 24 小时后失效,需长期保存请下载到自有存储。
- Seedream 系列对中文场景的理解表现出色,推荐中文 prompt。
- 失败请求(含上游 502)全额返还本次扣费,不计费。