OpenAI / Google · POST /v1/edits · 同步图生图 / 异步图生图兼容路径

POST 
/v1/edits

基本信息

• Base URL：https://api.dshub.top
• 主端点：POST /v1/edits（兼容路径，推荐新接入使用 /v1/images/edits）
• 兼容端点：POST /v1/edits
• Content-Type：multipart/form-data 或 application/json
• 用途：OpenAI / Google 图片编辑与图生图。标题中已经写明真实请求路径，下面按厂商和同步/异步拆开。

路径总览

厂商	模式	场景	请求路径	查询路径
OpenAI	同步生图	同步图生图 / 图片编辑	POST /v1/images/edits 或 POST /v1/edits	无需查询，响应直接返回图片
OpenAI	异步生图	异步图生图	POST /v1/images/generations + "async": true + 参考图 URL	GET /v1/images/generations/{task_id}
Google	异步生图	异步图生图 / URL 图片编辑	POST /v1/images/edits 或 POST /v1/edits	GET /v1/images/generations/{task_id}

OpenAI

同步生图 / 同步图生图

上传本地图片文件时使用 multipart/form-data。主路径是 POST /v1/images/edits，兼容路径是 POST /v1/edits。多图时重复同名 image 字段，不要写成 image[]。成功响应直接返回 data[].b64_json 或 data[].url。

异步生图 / 异步图生图

如果参考图是 URL / Data URL，推荐使用标准异步图片任务：POST /v1/images/generations，传 "async": true 和 images。提交成功后用 GET /v1/images/generations/{task_id} 查询。

Google

同步生图

Google Nano Banana 同步返回请使用 Gemini 原生路径：POST /v1beta/models/{model}:generateContent。

异步生图 / 异步图生图

参考图使用 URL / Data URL，主路径是 POST /v1/images/edits，兼容路径是 POST /v1/edits。请求体为 application/json，用 images / image / input_reference 传参考图。

异步查询

Google 图生图任务用 GET /v1/images/generations/{task_id} 查询。

OpenAI multipart 参数

• model：gpt-image-2 或 gpt-image-2-all。
• image：必填，1 到 10 张。多图请重复传同名 image 字段。
• prompt：必填，写清楚要编辑的目标。
• mask：可选 PNG 遮罩，透明区域表示需要编辑的位置。
• size：决定 1K / 2K / 4K 档位。quality 不改变档位。
  • 1K：长边 ≤ 1536，如不传、auto、1024x1024、1536x1024、1024x1536
  • 2K：长边 1537–2048，如 2048x2048、2048x1152、1152x2048；1792x1024、1008x1792 也按 2K
  • 4K：长边 > 2048，如 3840x2160、2160x3840；4K 受总像素上限 8,294,400 约束，1:1 的 4K 是 2880x2880
  • 计费档按请求的 size 定，不按实际交付尺寸；quality 不改变档位；显式传 resolution / image_size（1K / 2K / 4K）时以它为准。
  • 2K / 4K 尺寸沿用 OpenAI 官方口径：2048x2048（2K square）、2048x1152（2K landscape）、3840x2160（4K landscape）、2160x3840（4K portrait）。2560x1440 以上属于实验性分辨率，不保证每次都按该尺寸交付。出处：OpenAI 图像生成指南
  • 自定义 WIDTHxHEIGHT：两边为 16 的倍数，最长边 ≤ 3840，长宽比 ≤ 3:1，总像素 655,360–8,294,400。
• quality：low、medium、high、auto，不传默认 high。
• n：1 到 10。

JSON URL 图生图参数

• model：推荐 nano-banana-2/edit 或 nano-banana-pro/edit；也可用统一模型 nano-banana-2 / nano-banana-pro。
• prompt：必填，最长 10000 字符。
• images：参考图 URL / Data URL 数组，最多 5 张。
• image / input_reference：兼容字段，单图或多图均可。
• aspect_ratio：只接受 auto、1:1、9:16、16:9。
• resolution：Nano Banana Pro 可传 1k、2k、4k。

cURL：OpenAI gpt-image-2 文件上传图生图

curl --location --request POST 'https://api.dshub.top/v1/images/edits' \
  --header 'Authorization: Bearer sk-xxx' \
  --form 'model="gpt-image-2"' \
  --form 'image=@"/path/to/reference.png"' \
  --form 'prompt="保持主体不变，改成自然窗光和浅色背景"' \
  --form 'quality="high"' \
  --form 'size="1024x1024"'

cURL：OpenAI gpt-image-2 多图融合

curl --location --request POST 'https://api.dshub.top/v1/images/edits' \
  --header 'Authorization: Bearer sk-xxx' \
  --form 'model="gpt-image-2"' \
  --form 'image=@"/path/to/person.png"' \
  --form 'image=@"/path/to/product.png"' \
  --form 'prompt="将人物与产品合成同一张商业海报，统一光线和透视"' \
  --form 'quality="high"' \
  --form 'size="1536x1024"'

cURL：Google Nano Banana URL 图生图

curl --location --request POST 'https://api.dshub.top/v1/images/edits' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "nano-banana-pro/edit",
    "prompt": "把参考图改成高级电商主图，保留商品结构，白底柔光",
    "images": ["https://example.com/product.png"],
    "resolution": "4k",
    "aspect_ratio": "1:1"
  }'

返回说明

• 同步 OpenAI 图片编辑：返回 data[].b64_json 或 data[].url。
• 任务型 Google 图片编辑：返回任务对象，拿到 task_id 后调用 GET /v1/images/generations/{task_id} 查询。

鉴权提示

在线运行面板应使用 Authorization: Bearer sk-xxx。请把环境变量 token 设置为控制台复制的完整 API Key；不要把 Bearer 写进 token 变量。

Request

Responses

200

Response Headers