生图 / 图像编辑 接口 curl 示例大全#

更新日期：2026-08-12。本文覆盖生图/编辑接口所有支持的能力组合，供下游接入参考。
按业务场景分三大类：文生图（纯文本→图）、参考图生图（带参考图→新图）、图像编辑（改图/多图合成/蒙版）。

〇、通用前置#

0.1 服务地址与认证#

0.2 模型命名与路由#

前缀第一段必须是库中 proxy_channels.channel_code 实际值（示例的 nano-banana/aliyun_img/ms_img/azure 以你库为准）。

0.3 三个生图渠道与能力差异速览#

0.4 图片 base64 data URI 准备#

⚠️ Windows PowerShell 内联中文可能被转 GBK 导致上游 400 invalid_json。凡含中文的 JSON 一律存 UTF-8 文件用 --data-binary @req.json 提交。

一、文生图（纯文本 → 图片）#

入口：POST /v1/images/generations，不带 images。

1.1 最简文生图（Gemini / nano banana）#

1.2 全参数文生图（Azure / OpenAI）#

OpenAI 系支持：n / size / quality(low|medium|high) / output_format(png|jpeg) / output_compression / background / moderation / seed / user。

1.3 指定尺寸与张数（DashScope）#

DashScope 把 1024x1024 自动转 1024*1024；2K 等原样透传。不支持 quality/style/output_format。

1.4 带生成参数（Gemini，extra_params 透传）#

Gemini 入口的 n / size 会被安全忽略，尺寸/采样参数走 extra_params.generationConfig。

1.5 带渠道专属参数（DashScope）#

二、参考图生图 / 图生图（带参考图 → 新图）#

入口：POST /v1/images/generations，带 images 数组（元素可为 base64 data URI 字符串、{"image_url": ...} 对象、或纯 URL）。
网关自动识别"带图即编辑"（图生图=图像编辑）：Gemini/DashScope 参考图进 content parts；Azure/OpenAI 自动切到 edits 端点。

2.1 单参考图（Gemini，base64 data URI）#

2.2 单参考图（Gemini，普通 URL）#

URL 必须公网可访问；网关下载失败会报错（不会静默丢图）。DashScope 直接透传 URL，OpenAI/Azure/Gemini 下载转 base64。

2.3 双图合并 / 替换（Gemini，顺序即编号）#

// req.json
{
  "model": "vp/gemini-3.1-flash-lite-image",
  "prompt": "把第二张图的女孩放到第一张图的沙发上，保持第一张图其余部分不变",
  "images": [
    { "image_url": "data:image/jpeg;base64,[BASE64_1 底图]" },
    { "image_url": "data:image/jpeg;base64,[BASE64_2 参考图 女孩]" }
  ]
}

2.4 三图多区域替换（Gemini）#

{
  "model": "vp/gemini-3.1-flash-lite-image",
  "prompt": "把第二张图的女孩放到第一张图的沙发上，第三张图的猫放到窗台上，其余保持不变",
  "images": [
    { "image_url": "data:image/jpeg;base64,[BASE64_1 底图]" },
    { "image_url": "data:image/jpeg;base64,[BASE64_2 女孩]" },
    { "image_url": "data:image/jpeg;base64,[BASE64_3 猫]" }
  ]
}

2.5 遮罩场景（Gemini，顺序传图 + prompt 声明）#

{
  "model": "vp/gemini-3.1-flash-lite-image",
  "prompt": "第二张是遮罩图（白色区域为可编辑区域）。把第三张图的女孩合成到遮罩标记的沙发区域，遮罩之外保持原图完全不变",
  "images": [
    { "image_url": "data:image/png;base64,[BASE64_1 原图]" },
    { "image_url": "data:image/png;base64,[BASE64_2 遮罩图 白=可编辑]" },
    { "image_url": "data:image/png;base64,[BASE64_3 女孩]" }
  ]
}

当前遮罩走"顺序拼 parts + prompt 描述"，结构化 role/mask 字段未实现。

2.6 参考图生图（DashScope，多图）#

DashScope 的 base64 输入图自动上传 OSS 转 URL 再传给渠道接口。

2.7 参考图生图 / 编辑（Azure / OpenAI，带图自动走编辑）#

Azure/OpenAI 带图会切到 images/edits（cognitiveservices 域 + api-version 2025-04-01-preview），size/quality/output_format/n 随 multipart 透传。

三、图像编辑#

入口：POST /v1/images/edits，两种 Content-Type 自动分派：multipart/form-data 或 application/json。

3.1 multipart 单图编辑（Gemini）#

3.2 multipart 带蒙版（Azure）#

3.3 multipart 多图（OpenAI 原生 image[] 数组）#

multipart 仅支持：image（单张或多张，image/image[]）/ mask（可选）/ prompt / model。

3.4 JSON 编辑（Azure，images 数组 base64）#

JSON 编辑的 images 数组支持纯字符串（data URI/URL）或对象 {"image_url": ...} 两种形态。

3.5 JSON 编辑（Gemini / DashScope，多图合成）#

3.6 JSON 编辑带尺寸/质量/格式（任何支持编辑的渠道）#

{
  "prompt": "把背景换成雪景",
  "model": "azure/gpt-image-2",
  "size": "1024x1024",
  "quality": "high",
  "output_format": "png",
  "n": 1,
  "images": [
    { "image_url": "data:image/png;base64,[BASE64 原图]" }
  ]
}

mask 目前仅 multipart 支持（JSON 无 mask 字段）。

四、组合速查表#

五、参数支持矩阵（各渠道）#

六、常见报错与规避#