简介
本文汇总 Seedream 5.5 Pro 的模型信息、通用参数、基础响应、计费和错误处理。调用示例按场景提供:文生图 · 图生图、图层拆分。认证
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 美元。
