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

# Seedream 5.5 Pro · 参数与计费

> Seedream 5.5 Pro 认证、通用参数、响应字段、计费与错误处理

## 简介

本文汇总 Seedream 5.5 Pro 的模型信息、通用参数、基础响应、计费和错误处理。调用示例按场景提供：[文生图](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/generations.md) · [图生图、图层拆分](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/edits.md)。

## 认证

**Authorization** `string` *required*

Bearer Token，如 `Bearer sk-xxxxxxxxxx`

**Content-Type** `string` *required*

`application/json`

API Key 在平台的 API 密钥页面创建。请勿将 API Key 写入前端代码、公开仓库或客户端安装包。

## 模型信息

| 项目 | 说明 |
| - | - |
| 模型名称 | `dola-seedream-5-5-261028` |
| 文生图 | 支持 |
| 单图生图 / 图片编辑 | 支持 |
| 多图参考 / 图片融合 | 支持，最多 10 张参考图 |
| 交互编辑 | 支持（坐标、框选、箭头、草图） |
| 透明图（RGBA） | 文生图、图生图都支持 |
| 图层拆分 | 支持，1 张底图 + 最多 99 个图层 |
| 富文本 OCR | 支持（仅图层拆分场景） |
| 提示词优化 | 仅 `standard` |
| 提示词语言 | 中文、英文，以及俄、阿、菲、泰、土、韩、马来、西、葡、印尼、法、德、越、日语 |
| 组图 / 联网搜索 / 流式输出 | 不支持 |
| 单次输出数量 | 1 张（图层拆分除外） |
| 接口类型 | 同步返回 |

## 接口地址

```http theme={null}
POST https://api.gravitex.ai/v1/images/generations
```

`POST https://api.gravitex.ai/v1/images/edits` 与上面等价，请求体相同，平台都转发到上游的同一个生图接口。

## 请求参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| - | - | - | - | - |
| `model` | string | 是 | - | 固定为 `dola-seedream-5-5-261028` |
| `prompt` | string | 生成必填，图层拆分可选 | - | 生成或编辑指令；图层拆分时用来指定要拆的元素，详见 [prompt](#prompt) |
| `image` | string / string\[] | 文生图可选；图生图、图层拆分必填 | - | 参考图，URL 或 Base64；不传为文生图，详见 [image](#image) |
| `size` | string | 否 | 生成/编辑 `2K`；图层拆分 `auto` | 分辨率档位或 `宽x高`，详见 [size](#size) |
| `optimize_prompt_options` | object | 否 | `{"mode":"standard"}` | 提示词优化配置，`mode` 只能是 `standard` |
| `output_format` | string | 否 | `png` | 输出格式：`png`、`jpeg`。图层拆分时只控制底图，图层固定 `png` |
| `background` | string | 否 | `auto` | 透明通道模式：`auto`、`transparent`、`opaque`，详见 [background](#background) |
| `response_format` | string | 否 | `url` | 返回方式：`url`（24 小时内有效）或 `b64_json` |
| `watermark` | boolean | 否 | `true` | 是否在右下角添加「AI 生成」水印 |
| `layer_decomposition` | boolean | 否 | `false` | 是否开启图层拆分，详见 [layer\_decomposition](#layer_decomposition) |
| `layer_decomposition_options` | object | 否 | - | 图层拆分配置，仅 `layer_decomposition: true` 时生效，详见 [layer\_decomposition\_options](#layer_decomposition_options) |
| `safety_identifier` | string | 否 | - | 终端用户标识，详见 [safety\_identifier](#safety_identifier) |
| `n` | integer | 否 | `1` | 平台兼容字段；普通生成只输出 1 张，传 `1` 或不传；图层拆分数量由拆分规则决定 |

> [!WARNING]
>
> 以下参数该模型**不支持**，请不要传，否则上游可能报错：
>
> | 参数 | 说明 |
> | - | - |
> | `sequential_image_generation`、`sequential_image_generation_options` | 组图，仅 Seedream 5.0 lite / 4.5 / 4.0 支持 |
> | `stream` | 流式输出，仅 Seedream 5.0 lite / 4.5 / 4.0 支持 |
> | `tools` | 联网搜索，仅火山方舟的 Seedream 5.0 lite 支持 |
> | `quality` | 不是 Seedream 官方参数，分辨率请用 `size` 控制 |

### prompt

生成和编辑时必填；图层拆分时可省略。中文建议不超过 300 字，英文不超过 600 词。交互编辑见 [图生图说明](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/edits.md#prompt)。

### image

使用要求与详细说明见 [场景参数说明](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/edits.md#image)。

### size

**图片生成场景**：两种写法任选其一，不可混用。

* **写法 1（推荐）**：传分辨率档位 `1K`、`1.5K`、`2K`，默认 `2K`。在 `prompt` 里用自然语言描述宽高比、形状或用途，由模型决定最终尺寸。
* **写法 2**：传 `宽x高`（小写字母 `x`），需同时满足：
  * 总像素 \[1280×720（921600）, 2048×2048×1.1025（4624220）]
  * 宽高比 \[1/16, 16]

| 示例 | 是否有效 | 原因 |
| - | - | - |
| `2880x1440` | 有效 | 总像素 4147200，宽高比 2 |
| `1024x1024` | 有效 | 总像素 1048576 |
| `512x512` | 无效 | 总像素 262144，低于 921600 |

**图层拆分场景**：只支持档位 `1K`、`1.5K`、`2K`、`auto`，默认 `auto`。

* 底图分辨率与 `size` 一致，宽高比与原图一致。
* 每个图层分辨率接近 `size`，宽高比与它在原图中的宽高比一致。
* `auto`：按原始尺寸输出；原始尺寸小于 1K 时按 1K 输出，大于 2K 时按 2K 输出，宽高比都保持不变。

档位对应的常见像素值（不限于以下值）：

| 宽高比 | 1K | 1.5K | 2K |
| - | - | - | - |
| 1:1 | 1024x1024 | 1536x1536 | 2048x2048 |
| 4:3 | 1152x864 | 1792x1344 | 2368x1776 |
| 3:4 | 864x1152 | 1344x1792 | 1776x2368 |
| 16:9 | 1424x800 | 2048x1152 | 2816x1584 |
| 9:16 | 800x1424 | 1152x2048 | 1584x2816 |
| 3:2 | 1248x832 | 1872x1248 | 2496x1664 |
| 2:3 | 832x1248 | 1248x1872 | 1664x2496 |
| 21:9 | 1568x672 | 2352x1008 | 3136x1344 |

### background

使用要求与详细说明见 [场景参数说明](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/generations.md#background)。

### layer\_decomposition

使用要求与详细说明见 [场景参数说明](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/edits.md#layer_decomposition)。

### layer\_decomposition\_options

使用要求与详细说明见 [场景参数说明](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/edits.md#layer_decomposition_options)。

### safety\_identifier

终端用户的唯一标识，帮助上游识别可能违反使用政策的用户。

* 英文字符串，对同一用户固定且唯一，不超过 64 个字符。
* 推荐传用户名、用户 ID 或邮箱的哈希值，避免泄露隐私。
* 请求里传了，响应会原样返回。

```json theme={null}
{
  "safety_identifier": "5f4dcc3b5aa765d61d8327deb882cf99"
}
```

## 成功返回

普通生成返回 1 张图片；图生图的 `usage.input_images` 按实际输入张数统计。以下 URL 仅用于展示响应结构。

```json theme={null}
{
  "model": "dola-seedream-5-5-261028",
  "created": 1784868948,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "size": "2048x2048",
      "output_format": "png",
      "background": "opaque"
    }
  ],
  "usage": {
    "input_images": 0,
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}
```

### 返回字段

| 字段 | 类型 | 说明 |
| - | - | - |
| `model` | string | 实际使用的模型 ID（名称-版本） |
| `created` | integer | 创建时间，Unix 秒 |
| `data` | array | 输出图片列表；图片生成为 1 项，图层拆分为底图 + 各图层 |
| `data[].url` | string | 图片地址，`response_format` 为 `url` 时返回，**24 小时内有效** |
| `data[].b64_json` | string | Base64 图片内容，`response_format` 为 `b64_json` 时返回 |
| `data[].size` | string | 实际输出像素尺寸，如 `2048x2048` |
| `data[].output_format` | string | 实际输出格式 `png` / `jpeg`；图层拆分时图层固定 `png` |
| `data[].background` | string | 实际透明度：`transparent`（存在透明或半透明像素）/ `opaque`（整体不透明） |
| `safety_identifier` | string | 请求传了 `safety_identifier` 时原样返回 |
| `usage.input_images` | integer | 输入图片数 |
| `usage.generated_images` | integer | 成功生成的图片数，计费依据；图层拆分时含底图和全部图层 |
| `usage.output_tokens` | integer | 输出 token，`sum(宽 × 高) / 256` 取整 |
| `usage.total_tokens` | integer | 总 token，当前不计输入 token，等于 `output_tokens` |
| `error.code` / `error.message` | string | 整个请求没生成任何图片时返回 |

图层拆分额外字段、OCR 和图层还原方法见 [图生图返回说明](https://docs.gravitex.ai/cn/api-reference/endpoint/seedream-5.5/edits.md#返回字段)。图片 URL 24 小时内有效，请及时下载保存。

## 计费说明

**计费公式**：单次费用 = Σ 每张参考图 × 参考图单价 + Σ 每张输出图 × 所在档位的输出单价

| 计费项 | 档位 | 单价（美元 / 张） |
| - | - | - |
| 参考图 | 每张（含第 1 张） | 0.008 |
| 输出图（图片生成） | 总像素 ≤ 261 万（1.5K 及以下） | 0.020 |
| 输出图（图片生成） | 总像素 > 261 万（高于 1.5K） | 0.035 |
| 拆图输出（图层拆分） | 总像素 ≤ 261 万 | 0.020 |
| 拆图输出（图层拆分） | 总像素 > 261 万 | 0.035 |

* 以上为官方基础价，实际扣费再乘以令牌所在分组的倍率，以模型广场展示的价格为准。
* 按**成功生成的图片张数**（`usage.generated_images`）计费，审核不通过等原因没有输出的图片不计费。
* 每张输出图按自己的实际像素单独定档。图层拆分时，底图和每个图层分别算一张，各自按尺寸落在不同档位。
* 与 5.0 Pro 不同，5.5 的图层拆分**不打折**，和普通生成同价；一次最多可输出 100 张（`max_images` 上限），对成本敏感时请设置合适的 `max_images`。

**示例**：

* 传 2 张参考图生成 1 张 2048×2048 的图片：参考图 2 × 0.008 = 0.016，输出 0.035，合计 **0.051 美元**。
* 拆分 1 张图，输出 1 张 2048×2048 底图 + 6 个 1K 以内的图层：参考图 0.008，底图 0.035，图层 6 × 0.020 = 0.12，合计 **0.163 美元**。

## 错误处理

请求失败时返回 JSON 错误对象：

```json theme={null}
{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "code": "InvalidParameter"
  }
}
```

常见问题：

| 问题 | 处理建议 |
| - | - |
| API Key 无效 | 检查 `Authorization: Bearer ...` 是否正确 |
| 生成时缺少 `prompt` | 图片生成场景必须传非空 `prompt` |
| 参考图无法读取 | 检查 URL 是否公网可访问、是否过期；Base64 是否带 `data:image/<格式>;base64,` 前缀 |
| 尺寸不支持 | 用 `1K` / `1.5K` / `2K`，或总像素在 \[921600, 4624220] 内的 `宽x高` |
| 图层拆分报错 | 确认只传了 1 张图、格式为 png / jpeg、总像素不低于 512×512，且没有传 `background` |
| `max_images` 报错 | 取值必须在 \[2, 100] 内 |
| 透明图报错 | `background: "transparent"` 时 `output_format` 不能是 `jpeg` |
| `optimize_prompt_options.mode` 报错 | 该模型只支持 `standard` |
| 传入不支持的参数 | 删掉组图、流式、联网搜索等参数后重试 |
| 希望一次生成多张 | 分别发起多次请求 |
| 返回 URL 失效 | 收到响应后立即下载并持久化 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.