> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream 5.0 Flash 与 5.0 Pro API 上线：价格、区别与接入

> 2026 年 9 月 25 日老张API上线 Seedream 5.0 Flash（每次 0.018 美元）与 5.0 Pro（每次 0.12 美元）：两款模型怎么选、尺寸限制、Flash 分层透明图层、迁移注意事项与调用示例。

* **发布日期**：2026 年 9 月 25 日
* **最后核对**：2026 年 9 月 25 日
* **当前状态**：有效

老张API新增两款 Seedream 图像模型：Seedream 5.0 Flash（`seedream-5-0-flash-260915`）每次 \$0.018，适合大批量和带文字的设计图；Seedream 5.0 Pro（`seedream-5-0-pro-260628`）每次 \$0.12，画质最高但出图约需 2 分钟。

<Warning>
  **两款新模型都不支持 `sequential_image_generation` 和 `stream`，请求里带上任何值（包括 `"disabled"`）都会返回 400。**

  从 Seedream 5.0、4.5、4.0 切换过来时，先删掉这两个字段，其他参数一般只改 `model` 即可。
</Warning>

## 关键事实

| 项目                 | 内容                                             |
| ------------------ | ---------------------------------------------- |
| Seedream 5.0 Flash | `seedream-5-0-flash-260915`，\$0.018/次          |
| Seedream 5.0 Pro   | `seedream-5-0-pro-260628`，\$0.12/次             |
| 计费                 | 按次计费，每输出一张图计一次，不分尺寸                            |
| 参考图费用              | Flash 不收费；Pro 第 1 张免费，从第 2 张起每张 \$0.003        |
| 接口                 | `POST /v1/images/generations`，JSON 请求体，生成与编辑共用 |
| 参考图                | `image` 传 1–10 张，公网 URL 或 Base64 data URL      |
| 令牌                 | `default` 分组，计费模式为按量优先（推荐）或按次计费                |
| 价格来源               | 2026 年 9 月 25 日公开价格配置，见[模型与价格总表](/models)      |

## Flash 和 Pro 怎么选

| 对比项         | 5.0 Flash        | 5.0 Pro        |
| ----------- | ---------------- | -------------- |
| 单价          | \$0.018/次        | \$0.12/次       |
| 出图时间        | 通常 20 秒以内        | 常见约 2 分钟       |
| 建议客户端超时     | 60 秒起            | 240 秒以上        |
| `size` 预设档位 | `1K`、`1.5K`、`2K` | `1K`、`2K`      |
| 擅长          | 版面排版、多语种文字、明亮配色  | 写实人像、材质细节、复杂指令 |
| 分层（透明图层）    | 支持               | 不支持            |

* **选 Flash**：电商主图、广告素材、海报封面等需要批量出图或图中有文字的任务。Flash 的单价与 BytePlus 官方价格相同，是 Seedream 全系最低价。
* **选 Pro**：对画质要求最高的专业场景。BytePlus 官方对 Pro 按输出像素分档，并对输入参考图另行收费；老张API统一为每次 \$0.12，不分尺寸档；参考图第 1 张免费，从第 2 张起每张 \$0.003，传满 10 张最多多收 \$0.027。
* **继续用其他版本**：需要 3K 或组图模式用 Seedream 5.0（`seedream-5-0-260128`）；需要 4K 用 4.5 或 4.0。现有版本全部继续可用，不需要迁移。

## 你需要做什么

<Steps>
  <Step title="确认令牌">
    在[令牌管理](https://api.laozhang.ai/token)使用 `default` 分组的令牌，计费模式为「按量优先」（推荐）或「按次计费」。已有调用 Seedream 5.0 的令牌可以直接调用两款新模型。
  </Step>

  <Step title="改模型 ID 并清理字段">
    把 `model` 换成新模型 ID；删掉 `sequential_image_generation` 和 `stream`；显式传 `"watermark": false`，否则图片右下角会带「AI generated」水印。
  </Step>

  <Step title="按模型调整尺寸与超时">
    Flash 和 Pro 都没有 `3K`、`4K` 档，传入会返回 400。使用 Pro 时把客户端、反向代理和网关的超时一起调到 240 秒以上。
  </Step>
</Steps>

## 调用示例

用 Flash 生成一张带中文标题的海报（下载图片需要安装 `jq`）：

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API密钥"

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-flash-260915",
    "prompt": "咖啡店秋季新品海报，大标题「秋日限定」，副标题「栗子拿铁 第二杯半价」，暖橙色调，杂志风排版",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' \
  -o flash-poster.json

# 返回的 URL 约 24 小时后失效，拿到后尽快下载
curl -s -o flash-poster.jpg "$(jq -r '.data[0].url' flash-poster.json)"
```

* 换成 Pro 时只改 `model`，并把 cURL 的等待时间留足（可加 `--max-time 300`）。
* 预设档位下，画面宽高比由模型按内容决定。需要固定比例时直接写像素宽高，例如 16:9 横图传 `"size": "2560x1440"`。
* 改图时加上 `image`，写法与 Seedream 5.0 相同，见 [Seedream API 图改图](/api-capabilities/seedream-image#图改图)。

## 各模型尺寸限制

| 模型                          | 预设档位                       | 像素宽高                                     |
| --------------------------- | -------------------------- | ---------------------------------------- |
| `seedream-5-0-flash-260915` | `1K`、`1.5K`、`2K`，不传时按 `2K` | 总像素 921,600–4,624,220，长短边比不超过 16:1       |
| `seedream-5-0-pro-260628`   | `1K`、`2K`                  | 总像素不超过约 419 万，例如 `2048x2048`、`2720x1530` |

## Flash 分层：拆出透明图层

Flash 可以把一张成品图拆成一张补全后的背景底图和若干张透明图层，每个图层只含一个元素，适合换背景、二次排版和素材复用。只在提示词里要求「透明背景」得不到 alpha 通道，需要透明素材时用分层。

```bash theme={null}
curl --fail-with-body --max-time 360 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-flash-260915",
    "prompt": "把图片拆分为背景和各个独立元素的图层",
    "image": ["https://example.com/your-poster.jpg"],
    "layer_decomposition": true,
    "size": "1K",
    "output_format": "png",
    "response_format": "url",
    "watermark": false
  }' \
  -o flash-layers.json
```

把 `image` 换成你自己可公网下载的图片。响应的 `data[]` 中，第 1 张是背景底图，其余是 RGBA 透明图层，逐项下载保存即可。

<Warning>
  **分层按输出张数计费，返回几张就计几次 \$0.018。**

  * 图层数量由画面内容决定，无法事先指定；同一张图两次分层的张数也可能不同，常见为十几张，例如返回 16 张计 \$0.288。
  * 使用 `"size": "1K"`，客户端超时设到 300 秒以上。2K 分层耗时可能很长，客户端提前断开后请求仍会计费。
  * 图片无法分层时返回 400，不计费。
  * 底图里被移走元素的位置是模型补画的内容，商用前请人工检查。
</Warning>

## 常见问题

### \$0.018 是每次请求还是每张图？

每输出一张图计一次。普通生成和改图每次只出一张，所以一次请求就是 \$0.018；分层会返回多张，按实际张数计费。Flash 的参考图不收费；Pro 的参考图从第 2 张起每张另收 \$0.003。实际扣费以[调用日志](/faq/call-logs)为准。

### 传了 `n` 能一次出多张吗？

不能。两款新模型都会忽略 `n`，每次只返回一张。需要多张时发起多次请求；两款模型也不支持组图模式。

### 旧版 Seedream 需要迁移吗？

不需要。`seedream-5-0-260128`、`seedream-4-5-251128`、`seedream-4-0-250828` 继续可用，价格不变。想降低成本时，可以用同一批提示词在 Flash 上小批量对比效果，再决定是否切换。

### Pro 请求一直没有返回怎么办？

Pro 常见约 2 分钟出图，先确认客户端和中间代理的超时在 240 秒以上。客户端超时不等于请求失败，服务端可能已经生成并扣费；重新提交前先到[调用日志](/faq/call-logs)确认该请求的状态。

### 为什么返回 400？

先对照以下几项：

* 请求里带了 `sequential_image_generation` 或 `stream`；
* `size` 用了 `3K`、`4K`，或像素宽高超出对应模型的范围；
* 参考图超过 10 张；
* 分层时图片无法拆分（不计费，可换图或重试）。

## 来源与相关文档

* [Seedream API：图片生成与编辑](/api-capabilities/seedream-image)：全系列接入示例、参数与常见问题
* [图像生成 API 选型与价格](/api-capabilities/image-generation-guide)：与 GPT Image、Nano Banana、FLUX.2 对比
* [模型与价格总表](/models)：当前价格与可用分组
* [控制台模型价格](https://api.laozhang.ai/account/pricing)：登录后查看令牌可用的模型与单价
* [BytePlus ModelArk 图像生成 API](https://docs.byteplus.com/en/docs/ModelArk/1541523)：官方参数说明与取值范围
* [BytePlus 图像生成教程](https://docs.byteplus.com/en/docs/ModelArk/1824121)：各版本能力对比与参考图限制