seedream 系列
seedream 系列统一入口说明
- 本页说明平台
POST /v1/images/generations在 seedream 系列上的实际行为。 - 重点是统一入口里的参数行为与规则，不只是字段表面含义。
基础信息
| 项目 | 说明 |
|---|---|
| 统一入口 | POST /v1/images/generations |
| 鉴权方式 | Authorization: Bearer YOUR_API_KEY |
| 适用模型 | doubao-seedream-4.0、doubao-seedream-4.5、bytedance-seedream-5.0 |
建议先在 shell 里准备两个变量：
BASE_URL="https://api-platform.ope.ai"
API_KEY="YOUR_API_KEY"
价格信息请查看：模型价格。
1. 统一入口字段行为
| 统一入口字段 | 平台处理 | 说明 |
|---|---|---|
model | 归一化 | 会做 seedream 模型名归一化（见下表） |
prompt | 直接处理 | 作为提示词传入 |
size | 直接处理 | 未传时按模型补默认值 |
response_format | 约束校验 | 仅接受 b64_json、url |
image | 直接处理 | 支持图生图/多图融合 |
stream | 默认值 | 默认 false |
watermark | 默认值 | 默认 false |
sequential_image_generation | 条件生效 | 仅 seedream 模型生效，支持 disabled、auto |
n | 条件改写 | 仅在 seedream 且 n > 1 且未显式传 sequential_image_generation 时，自动改写为 auto + max_images=n |
当前统一入口不生效字段：quality、style、user、output_format、output_compression、background、moderation。
2. 模型 ID 归一化（平台内部）
请求 model | 归一化后 model |
|---|---|
doubao-seedream-4.5 / doubao-seedream-4-5-251128 | seedream-4-5-251128 |
doubao-seedream-4.0 / doubao-seedream-4-0-250828 | seedream-4-0-250828 |
bytedance-seedream-5.0 | bytedance-seedream-5.0 |
size 默认值规则：
- 对
doubao-seedream-3-0-t2i-250415/seedream-3-0-t2i-250415：默认1024x1024 - 对其他 seedream：默认
2K
3. Size 可用值（seedream 原生规格）
平台对
size做透传。你可以传2K/3K/4K，也可以直接传具体分辨率（推荐直接传分辨率）。
参考：火山引擎官方文档 图像生成
| 档位 | 比例 | 分辨率（size） |
|---|---|---|
| 2K | 1:1 | 2048x2048 |
| 2K | 4:3 | 2304x1728 |
| 2K | 3:4 | 1728x2304 |
| 2K | 16:9 | 2848x1600 |
| 2K | 9:16 | 1600x2848 |
| 2K | 3:2 | 2496x1664 |
| 2K | 2:3 | 1664x2496 |
| 2K | 21:9 | 3136x1344 |
| 3K | 1:1 | 3072x3072 |
| 3K | 4:3 | 3456x2592 |
| 3K | 3:4 | 2592x3456 |
| 3K | 16:9 | 4096x2304 |
| 3K | 9:16 | 2304x4096 |
| 3K | 2:3 | 2496x3744 |
| 3K | 3:2 | 3744x2496 |
| 3K | 21:9 | 4704x2016 |
| 4K | 1:1 | 4096x4096 |
| 4K | 3:4 | 3520x4704 |
| 4K | 4:3 | 4704x3520 |
| 4K | 16:9 | 5504x3040 |
| 4K | 9:16 | 3040x5504 |
| 4K | 2:3 | 3328x4992 |
| 4K | 3:2 | 4992x3328 |
| 4K | 21:9 | 6240x2656 |
4. n 参数语义（重点）
n默认值是1。- seedream 系列中，
n不是“强制生成 n 张”。 - 实际逻辑是：在组图模式下，
n仅作为max_images上限，最终出图张数由模型根据提示词自动决定。 - 官方上限建议为
[1, 15]；建议按该范围传参。
网关自动改写示例（当 n > 1 且你未显式传 sequential_image_generation）：
{
"sequential_image_generation": "auto",
"sequential_image_generation_options": {
"max_images": 8
}
}
5. 创建请求示例
curl --request POST "$BASE_URL/v1/images/generations" \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "bytedance-seedream-5.0",
"prompt": "生成一组同一角色在不同机位下的电影感海报，画面风格统一。",
"size": "4096x2304",
"n": 8,
"response_format": "url"
}'