图片生成与参考图创作

一次调用的顺序

选择模型与规格 → 有参考图时先上传 → 创建图片任务 → 查询终态 → 下载结果。接口为 POST /images/generations。

文生图、单图编辑、多图参考不是所有模型都支持。input_image_asset_id、input_image_asset_ids、size 和生成张数均应使用目标服务“API 接入”给出的合法字段，不要枚举清晰度和比例的所有笛卡尔积。

文生图请求体

下面表示请求结构。将 model 和 size 换成目标模型支持的值；不要因为其他模型接受某个尺寸就照抄。

{
  "model": "<MODEL_ALIAS>",
  "prompt": "明亮的产品海报，简洁背景，自然光线",
  "size": "1024x1024",
  "seed": 42
}

使用参考图

按 素材上传 顺序上传每张图，保存 asset.assetId。支持多图参考的模型一般使用有序数组；只支持单图的服务使用其单图字段。

{
  "model": "<MODEL_ALIAS>",
  "prompt": "保留人物特征，将背景改为清晨街道",
  "input_image_asset_ids": ["<FIRST_ASSET_ID>", "<SECOND_ASSET_ID>"],
  "size": "1024x1024"
}

此多图示例仅适用于明确支持数组输入的模型。某些模型允许零张参考图，某些编辑模式要求至少一张；数量、顺序、像素和单图大小均从对应服务合同确认。不要同时传含义冲突的单图和数组字段。

创建后如何处理

使用目标操作要求的幂等键提交。成功的 202 不是图片完成，按 异步任务 保存原任务、查询并下载。失败时不要因“没有看到图片”连续点击或重提。

同规格价格可在模型广场查看；Account API Key 不提供独立的公开估价端点，创建时按服务当前价格规则准入与结算。不要调用应用调试专用准入接口代替个人报价。