图片变体

图片变体接口用于基于已有图片生成相近版本，适合做视觉方向探索、商品图备选和风格近似图。是否支持变体以所选模型说明为准。

接口路径

方法	路径	返回方式
POST	/v1/images/variations	同步返回图片变体结果。

请求示例

curl https://moonapix.com/v1/images/variations \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -F "image=@./product.png" \
  -F "model=gpt-image-2" \
  -F "n=2"

常用字段

字段	说明
image	输入图片文件。
model	图片模型名，以 MoonApiX 后台和 API Reference 为准。
n	生成数量。
size	输出尺寸，以 API Reference 为准。

结果处理

场景	处理方式
多版本候选	保存每个结果图和原图关系。
用户二次选择	将选中版本标记为业务主图。
继续编辑	将选中结果传入 图片编辑。

接入建议

• 用高质量原图作为输入，避免压缩痕迹影响结果。
• 保存输入图、生成参数和输出图，方便用户回溯。
• 如果需要明确修改方向，请使用 图片编辑。

相关页面

• 创建和编辑图片汇总
• 图片生成
• 上传与素材
• API Reference