跳转到主要内容

简介

本文汇总 Seedream 5.5 Pro 的模型信息、通用参数、基础响应、计费和错误处理。调用示例按场景提供:文生图 · 图生图、图层拆分。

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx
string
必填
application/json
API Key 在平台的 API 密钥页面创建。请勿将 API Key 写入前端代码、公开仓库或客户端安装包。

模型信息

接口地址

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

请求参数

以下参数该模型不支持,请不要传,否则上游可能报错:

prompt

生成和编辑时必填;图层拆分时可省略。中文建议不超过 300 字,英文不超过 600 词。交互编辑见 图生图说明。

image

使用要求与详细说明见 场景参数说明。

size

图片生成场景:两种写法任选其一,不可混用。
  • 写法 1(推荐):传分辨率档位 1K、1.5K、2K,默认 2K。在 prompt 里用自然语言描述宽高比、形状或用途,由模型决定最终尺寸。
  • 写法 2:传 宽x高(小写字母 x),需同时满足:
    • 总像素 [1280×720(921600), 2048×2048×1.1025(4624220)]
    • 宽高比 [1/16, 16]
图层拆分场景:只支持档位 1K、1.5K、2K、auto,默认 auto。
  • 底图分辨率与 size 一致,宽高比与原图一致。
  • 每个图层分辨率接近 size,宽高比与它在原图中的宽高比一致。
  • auto:按原始尺寸输出;原始尺寸小于 1K 时按 1K 输出,大于 2K 时按 2K 输出,宽高比都保持不变。
档位对应的常见像素值(不限于以下值):

background

使用要求与详细说明见 场景参数说明。

layer_decomposition

使用要求与详细说明见 场景参数说明。

layer_decomposition_options

使用要求与详细说明见 场景参数说明。

safety_identifier

终端用户的唯一标识,帮助上游识别可能违反使用政策的用户。
  • 英文字符串,对同一用户固定且唯一,不超过 64 个字符。
  • 推荐传用户名、用户 ID 或邮箱的哈希值,避免泄露隐私。
  • 请求里传了,响应会原样返回。

成功返回

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

返回字段

图层拆分额外字段、OCR 和图层还原方法见 图生图返回说明。图片 URL 24 小时内有效,请及时下载保存。

计费说明

计费公式:单次费用 = Σ 每张参考图 × 参考图单价 + Σ 每张输出图 × 所在档位的输出单价
  • 以上为官方基础价,实际扣费再乘以令牌所在分组的倍率,以模型广场展示的价格为准。
  • 按成功生成的图片张数(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 错误对象:
常见问题: