图像生成与编辑
Images API。按所选模型生成或编辑图片,按配置的分辨率档位和成功张数结算。
POST
/v1/images/generations当前支持范围
新请求使用 JSON;参考图和蒙版采用上游可读取的在线 URL,或所选模型明确支持的内联 Base64。 原始 Base64、data URI 等格式及大小限制须遵循该模型协议;不能据此推断其他厂商也支持。 不接收本地文件上传或平台文件 ID。编辑及流式能力以所选模型方案为准。 右侧生成样例适用于已上架的 Wan2.7 图片模型;其他模型的尺寸和参数需按其协议填写。
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 已上架且分组为 image 的模型 ID。 |
prompt | string | 是 | 图片生成提示词。 |
size | string | 例如 Wan2.7 的 1K / 2K / 4K;须配置对应售价,格式与可选值以上游模型为准。 | |
quality | string | 例如 low / medium / high;以上游模型为准。 | |
n | integer | 生成数量;模型可能只支持 1。 | |
output_format | string | 可选输出格式;以上游模型为准。 | |
background | string | 透明背景等控制;以上游模型为准。 |
图片编辑
POST
/v1/images/edits仅选择支持图片编辑的模型。参考图和可选蒙版通过 JSON 中的在线 URL,或该模型明确支持的内联 Base64 传递, 字段名、图片数量、格式和编辑参数由所选模型协议决定。平台不提供上传入口或素材托管。
内联 Base64 不建立独立文件台账,但完整请求快照会持久化于任务记录,用于恢复和相同幂等请求重放。 这不等于提供素材长期归档。
响应与计费
兼容响应通过 data 返回上游交付结果。图片按已配置的分辨率档位与成功张数结算; 每个请求固定使用受理时的价格快照。费用或用量无法确认时进入复核。 供应商结果 URL 的可读权限与有效期遵循上游,平台不自动下载或长期归档产物。