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

# Doubao-Seedream-5.0-Pro

Seedream-5.0-pro是字节跳动发布的最新图像创作模型。该模型将图像创作推进到可控生产的新阶段，本次更新的主要亮点是编辑更可控、生产更落地、效果更自然。

### 模型参数

* 模型ID：`doubao-seedream-5.0-pro`
* 模型价格：你可以在[模型详情页](https://geekai.co/models/doubao-seedream-5.0-pro)查看最新价格信息
* 调用入口：`https://geekai.co/api/v1/images/generations`
* 模型参数：参考[画图 API 手册](https://docs.geekai.co/cn/api/image/generations)
* API认证：[获取 API KEY](https://geekai.co/user/api_keys)

<Note>
  不支持画图 API 中的以下参数：

  * `negative_prompt`
  * `strength`
  * `aspect_ratio`
  * `quality`
  * `style_preset`
  * `mask`

  附：[Seedream 5.0 Pro 官方 API 文档](https://docs.volcengine.com/docs/82379/2582774)
</Note>

Doubao-Seedream-5.0-Pro 新增图层拆分功能，需要通过 `extra_body` 字段传入 `layer_decomposition` 参数来开启，具体使用方式请参考[图层拆分文档](https://docs.volcengine.com/docs/82379/2582774#%E5%9B%BE%E5%B1%82%E6%8B%86%E5%88%86%E6%A8%A1%E5%9E%8B)。

Doubao-Seedream-5.0-Pro 不支持设置图片宽高比及分辨率,可以通过 `size` 字段实现，该字段支持两种方式传值：

* 指定生成图像的分辨率: `1K`、`1.5K`、`2K`（普通生图场景默认值）、`auto`（图层拆分场景下默认值，仅图层拆分场景支持该参数值）, 并在 `prompt` 中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。
* 指定生成图像的宽高像素值，默认值是 `2048x2048`，对应宽高比为 1:1，此外还可以通过如下像素值生成不同宽高比的图片：

| 分辨率  | 宽高比  | 像素值       |
| ---- | ---- | --------- |
| 1K   | 1:1  | 1024x1024 |
|      | 4:3  | 1152x864  |
|      | 3:4  | 864x1152  |
|      | 16:9 | 1424x800  |
|      | 9:16 | 800x1424  |
|      | 3:2  | 1248x832  |
|      | 2:3  | 832x1248  |
|      | 21:9 | 1568x672  |
| 1.5K | 1:1  | 1536x1536 |
|      | 4:3  | 1792x1344 |
|      | 3:4  | 1344x1792 |
|      | 16:9 | 2048x1152 |
|      | 9:16 | 1152x2048 |
|      | 3:2  | 1872x1248 |
|      | 2:3  | 1248x1872 |
|      | 21:9 | 2352x1008 |
| 2K   | 1:1  | 2048x2048 |
|      | 4:3  | 2304x1728 |
|      | 3:4  | 1728x2304 |
|      | 16:9 | 2848x1600 |
|      | 9:16 | 1600x2848 |
|      | 3:2  | 2496x1664 |
|      | 2:3  | 1664x2496 |
|      | 21:9 | 3136x1344 |

Doubao-Seedream-5.0-Pro 支持通过 `output_format` 控制图片输出格式为 `png`、`jpeg`，默认值为 `png`。

Doubao-Seedream-5.0-Pro 支持通过 `response_format` 控制图片响应格式为 `url`、`b64_json`，默认值为 `url`。

Doubao-Seedream-5.0-Pro 支持通过 `background` 控制是否生成带透明通道的图片：

* `transparent`：透明背景模式，输出带有透明背景的图。
* `opaque`：不透明背景模式，生成常规的实体背景图。

使用限制：

* 仅支持图生图场景，且只支持输入 1 张带透明通道的图片；
* 透明背景模式下，输出图片默认为 png 格式，若同时配置 output\_format 为 jpeg，将触发报错；
* 若传入了不支持透明通道的文件格式（如 jpeg），将触发报错。

Doubao-Seedream-5.0-Pro 不再支持组图功能，所以组图相关参数传入无效。

### 模型价格

Doubao-Seedream-5.0-Pro 模型的价格按照生成图片的总像素来计算，以 261 万像素为分界线, 低于 261万像素 0.3 元/张，超过 261 万像素 0.6 元/张，图层拆分场景价格在此基础上减半。

由于 1K 和 1.5K 尺寸的图片总像素都小于261万像素，所以价格归于一档，以下是该模型的价格速算表：

| 模型ID                      | 场景   | 图片尺寸 | 价格（元/张） |
| ------------------------- | ---- | ---- | ------- |
| `doubao-seedream-5.0-pro` | 普通生图 | 1K   | 0.3     |
| `doubao-seedream-5.0-pro` | 普通生图 | 1.5K | 0.3     |
| `doubao-seedream-5.0-pro` | 普通生图 | 2K   | 0.6     |
| `doubao-seedream-5.0-pro` | 图层拆分 | 1K   | 0.15    |
| `doubao-seedream-5.0-pro` | 图层拆分 | 1.5K | 0.15    |
| `doubao-seedream-5.0-pro` | 图层拆分 | 2K   | 0.3     |

对于普通生图下的图生图场景，当输入图片超过 1 张时，输入图片也会参与计费，价格为 0.02 元/张，总计费逻辑为：总价格 = 输出图片价格 \* 输出图片数量 + 输入图片价格 \* (输入图片数量-1)。

图层拆分场景仅支持输入一张图片，因此可以看作输入免费，仅对输出图片计费。

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price)调用时，不同参数对应价格按照价格表x对应的折扣值即可。以高可用Pro通道为例，折扣值是 `0.8`，那么生成一张 `size` 为 `1K` 的图片价格是 `0.3 x 0.8 = 0.24` 元，对于拆分图层场景，对应价格是 `0.15 x 0.8 x 8 = 0.96` 元（拆分成8张）。其他参数依次类推。

### 文生图

通过给模型提供清晰准确的文字指令，即可快速获得符合描述的高质量单张图片：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedream-5.0-pro",
    "prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有Vogue杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。",
    "output_format":"png"
}'
```

响应是一个 JSON 对象，包含生成图片的 URL：

```json theme={null}
{
    "model": "doubao-seedream-5.0-pro",
    "created": 1787563947,
    "task_id": "eae17a81-d0b9-49a5-9c31-749d56f48a66",
    "task_status": "succeed",
    "data": [
        {
            "url": "https://static.geekai.co/image/2026/08/24/3875c0d7366011f7de9f32ec2f010f29.png",
            "size": "1776x2368"
        }
    ],
    "usage": {
        "billed_units": 1,
        "output_tokens": 16428,
        "total_tokens": 16428
    }
}
```

下面的图生图的输出结果同上述结果，不在列举。

### 图生图

Doubao-Seedream-5.0-Pro 支持图生图功能，可以在原有图片的基础上进行修改，生成新的图片。你可以通过 `image` 字段传入一张或多张图片，并在 `prompt` 中描述你希望对这些图片进行的修改。

**单图**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedream-5.0-pro",
    "prompt": "生成狗狗趴在草地上的近景画面",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png",
    "output_format":"jpeg"
}'
```

**多图**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedream-5.0-pro",
    "prompt": "将图1的服装换为图2的服装",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png", 
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ],
    "output_format":"png",
    "watermark": false
}'
```

### 拆分图层

Doubao-Seedream-5.0-Pro 支持将单张图片拆解为底图（1 张）+ 多个图层输出（最多 16 个图层）, 通过 `extra_body` 字段传入 `"layer_decomposition": true` 来开启：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedream-5.0-pro",
    "prompt": "将图片进行精确图层分离，需分离的文字坐标为<bbox>180 64 812 198</bbox>、<bbox>757 210 939 280</bbox>、<bbox>63 212 320 282</bbox>、<bbox>178 714 826 810</bbox>、<bbox>814 819 949 894</bbox>、<bbox>326 824 669 930</bbox>；鹦鹉的坐标为<bbox>347 305 642 997</bbox>。",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream_50_pro_layer_input.png",
    "extra_body": {
        "layer_decomposition": true
    }
}'
```

响应数据结构和官方一样，示例如下：

```json theme={null}
{
    "model": "doubao-seedream-5.0-pro",
    "created": 1787591524,
    "task_id": "1e0751ea-5842-441b-8704-db76d6bfabbe",
    "task_status": "succeed",
    "data": [
        {
            "url": "https://static.geekai.co/image/2026/08/25/495ae4923f0ee07739d30fb2decb9226.jpeg",
            "size": "1080x1080",
            "z_index": 0
        },
        {
            "url": "https://static.geekai.co/image/2026/08/25/8ff0eaa82dea85572e9e4a5e070e5531.png",
            "size": "934x257",
            "z_index": 1,
            "name": "底部三行说明文字",
            "description": "提取三行白色文字FLY BEYOND LIMITS、TROPICAL SPLENDOR、RANFOREST ADVENTURES，仅包含该文字本体，不包含其他无关内容",
            "bounding_box": {
                "absolute": [
                    372,
                    904,
                    711,
                    998
                ],
                "normalized": [
                    344,
                    837,
                    657,
                    923
                ]
            }
        },
        {
            "url": "https://static.geekai.co/image/2026/08/25/aad2af4d3433dfdec5cc3c24a875d6d1.png",
            "size": "1219x159",
            "z_index": 2,
            "name": "WILD BEAUTY文字",
            "description": "提取黄色文字WILD BEAUTY，仅包含该文字本体，不包含其他无关内容",
            "bounding_box": {
                "absolute": [
                    191,
                    781,
                    890,
                    872
                ],
                "normalized": [
                    177,
                    723,
                    823,
                    806
                ]
            }
        },
        {
            "url": "https://static.geekai.co/image/2026/08/25/18640aeef6c06e95d349f5dc88356c60.png",
            "size": "557x308",
            "z_index": 3,
            "name": "NATURE INSIDE标识文字",
            "description": "提取椭圆形标识内的白色文字NATURE INSIDE，仅包含该标识和文字本体，不包含其他无关内容",
            "bounding_box": {
                "absolute": [
                    887,
                    890,
                    1026,
                    967
                ],
                "normalized": [
                    821,
                    824,
                    949,
                    894
                ]
            }
        },
        {
            "url": "https://static.geekai.co/image/2026/08/25/b95fc950bf2cc5e764f43148b2d32e36.png",
            "size": "846x171",
            "z_index": 4,
            "name": "EXPLORE THE WILD文字",
            "description": "提取白色文字EXPLORE THE WILD, INSPIRE THE SOUL.，仅包含该文字本体，不包含其他无关内容",
            "bounding_box": {
                "absolute": [
                    73,
                    238,
                    333,
                    291
                ],
                "normalized": [
                    68,
                    220,
                    307,
                    269
                ]
            }
        },
        {
            "url": "https://static.geekai.co/image/2026/08/25/782d3237bc07337e7e264e996e2b3ab2.png",
            "size": "742x243",
            "z_index": 5,
            "name": "VOL.01 SUMMER 2026文字",
            "description": "提取白色文字VOL.01 SUMMER 2026，仅包含该文字本体，不包含其他无关内容",
            "bounding_box": {
                "absolute": [
                    826,
                    236,
                    1008,
                    296
                ],
                "normalized": [
                    765,
                    219,
                    932,
                    273
                ]
            }
        },
        {
            "url": "https://static.geekai.co/image/2026/08/25/0fa54bb5e4353d9333dd27078bf26039.png",
            "size": "1270x264",
            "z_index": 6,
            "name": "Seedream文字",
            "description": "提取黄色文字Seedream，仅包含该文字本体，不包含其他无关内容",
            "bounding_box": {
                "absolute": [
                    202,
                    63,
                    873,
                    202
                ],
                "normalized": [
                    187,
                    58,
                    807,
                    186
                ]
            }
        },
        {
            "url": "https://static.geekai.co/image/2026/08/25/53ffe8c784cd3c512289eac4a6d45ca4.png",
            "size": "425x1056",
            "z_index": 7,
            "name": "彩色金刚鹦鹉",
            "description": "提取栖息在树枝上的彩色红蓝色金刚鹦鹉，仅包含鹦鹉本体，不包含其他无关内容",
            "bounding_box": {
                "absolute": [
                    385,
                    330,
                    686,
                    1080
                ],
                "normalized": [
                    356,
                    306,
                    634,
                    999
                ]
            }
        }
    ],
    "usage": {
        "billed_units": 8,
        "output_tokens": 33349,
        "total_tokens": 33349
    }
}
```