OPENAI FORMAT // IMAGE RESPONSE

图片生成统一接口

主推 OpenAI Images 格式:文生图、参考图编辑、局部蒙版、透明背景、GIF 与 SVG 使用统一接口,参考图使用公网 HTTPS URL。只有必须直接提交 Base64 参考图时,才改用单独的 Gemini 原生格式。

Gemini + GPT Image默认异步任务最高 4K 原生档
POSThttps://vip.zpika.com/v1/images/generations

先选择接入路径

i默认选择 OpenAI Images 格式 + URL 参考图它是本站主推的新接入方式,适用于 GPT Image 和采用 OpenAI Images 格式的 Gemini 模型。当前参考图只能提交公网可读取的 HTTPS URL;没有图床时可使用本站无限画布上传素材,由画布生成并提交可访问的素材 URL。
用途方法与路径说明
文生图POST /v1/images/generationsJSON 请求,默认传 async: true 后轮询结果
参考图 / 编辑(主推)POST /v1/images/editsOpenAI Images JSON;参考图仅支持公网 HTTPS URL
Base64 参考图(例外)POST /v1beta/models/{model}:generateContentGemini 原生格式;仅使用不带 preview 的两个原生模型名
  • Base URL 固定使用 https://vip.zpika.com。
  • 先在 API 密钥页面创建图片分组 Key。Key 可调用哪些模型,以该 Key 实际返回的模型列表为准。
  • 图片接口支持同步和异步两种客户端模式:文档默认传 async: true 并立即保存任务 ID;省略 async 或传 false 时仍兼容同步等待。
  • 异步图片使用 GET /v1/images/generations/{task_id} 查询;编辑任务使用 GET /v1/images/edits/{task_id}。请求超时或断线后继续查询原任务,不要立即重复提交。
  • OpenAI Images 的参考图字段不接受 Base64、data URL、浏览器 blob: URL 或需要登录的分享页。确实需要 Base64 时,请查看 Gemini 原生 Base64 参考图。

模型怎么选

i无限画布按“基础系列 → 档位 → 质量”选择画布模型列表只显示基础系列名,再按当前 Key 实际返回的模型开放 Web、超分、1K、2K、4K 档位。选择 1K / 2K / 4K 后才显示五档质量;提交时画布会转换成下面列出的完整模型名。
Gemini 3.1 Flash Image

OpenAI Images 格式:gemini-3.1-flash-image-preview

Gemini 原生格式:gemini-3.1-flash-image

速度和性价比优先;OpenAI 格式使用 URL 参考图,原生格式可直接提交 Base64。

Gemini 3 Pro Image

OpenAI Images 格式:gemini-3-pro-image-preview

Gemini 原生格式:gemini-3.0-pro-image

复杂构图、多图融合和质量优先;OpenAI 格式使用 URL 参考图,原生格式可直接提交 Base64。

GPT Image 网页档gpt-image-2 gpt-image-2.5 gpt-image-2.6

快速出图,最高约 1.5K,最多 9 张参考图,支持透明背景;不要传 quality。

全站超分模型gpt-image-2.6-flare gpt-image-2.6-sunburst

全站只有这两个模型属于超分:Flare 偏快速迭代、商品图与海报版式,Sunburst 偏细节和精确编辑。一次 1 张、最多 9 张 URL 参考图,不传 quality。

GPT Image 2 原生档gpt-image-2-1k gpt-image-2-2k gpt-image-2-4k

Adobe 原生高速渠道,模型名直接锁定像素档,最多 9 张参考图,本站按固定单价结算。

Flare 原生档gpt-image-2.5/2.6-flare-{1k|2k|4k}

更快的日常高质量出图,适合新图、商品图、海报和批量试稿,最多 16 张参考图,支持五档 quality。

Sunburst 原生档gpt-image-2.5/2.6-sunburst-{1k|2k|4k}

细节和精确编辑优先,适合参考图局部修改与多轮迭代,最多 16 张参考图,支持五档 quality。

画布基础系列可选档位最终请求模型
gpt-image-2.6Web(最高约 1.5K)gpt-image-2.6
gpt-image-2.6-flare超分 / 1K / 2K / 4K超分使用无 K 名;其他档位使用 gpt-image-2.6-flare-{1k|2k|4k}
gpt-image-2.6-sunburst超分 / 1K / 2K / 4K超分使用无 K 名;其他档位使用 gpt-image-2.6-sunburst-{1k|2k|4k}

基础系列只是画布的折叠展示,不是新增 API 别名。直接调用 API 时必须发送最终完整模型名;某个档位未被当前 Key 返回时,画布不会显示该选项。

当前响应方式

提交请求中传 async: true,立即保存返回的任务 ID。
轮询每 5–10 秒查询同一个任务,页面刷新后继续恢复。
取图任务完成后读取 data[].url,并尽快下载或转存。
iasync: true 会返回可轮询任务异步创建响应包含 id、status 和 progress;终态查询再读取 data[].url。同步模式仍直接返回最终 OpenAI Images 响应。

图片调用消耗可在 ZPIKA 使用日志查看。异步结果 URL 是有签名和有效期的制品地址,可能不以图片扩展名结尾;下载时跟随重定向,并以 HTTP Content-Type 判断格式。

请求示例

Gemini 文生图

curl -X POST 'https://vip.zpika.com/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "雨夜霓虹街道上的未来感跑车,电影级灯光,无文字",
    "size": "16:9",
    "quality": "2k",
    "n": 1,
    "async": true
  }'

GPT Image 原生档

curl -X POST 'https://vip.zpika.com/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2.5-flare-2k",
    "prompt": "白色背景上的钴蓝色陶瓷花瓶,商品摄影,柔和棚拍光",
    "size": "1:1",
    "quality": "high",
    "output_format": "png",
    "n": 1,
    "async": true
  }'

GPT Image 2.6 无 K 超分静图

curl -X POST 'https://vip.zpika.com/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "精确保留产品轮廓与标签,只改善材质细节和棚拍光线",
    "images": ["https://example.com/reference.png"],
    "size": "4:3",
    "background": "opaque",
    "output_format": "png",
    "n": 1,
    "async": true
  }'

无 K 的 gpt-image-2.6、gpt-image-2.6-flare、gpt-image-2.6-sunburst 都不要传 quality。只有模型名带 -1k、-2k、-4k 的档位才使用质量参数。

异步创建与查询

{
  "created_at": 1794122548,
  "id": "task_...",
  "object": "image.generation",
  "progress": "20%",
  "status": "queued"
}
curl --fail-with-body --silent --show-error \
  'https://vip.zpika.com/v1/images/generations/TASK_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

参考图、编辑与蒙版

iOpenAI Images 参考图当前只支持 URLimages 数组中的每一项都必须是服务端无需登录即可读取的公网 HTTPS 图片地址。没有自己的图床时,可把图片上传到本站无限画布,再由画布提交素材 URL。

不要在 OpenAI Images 请求中传 Base64、data URL、网页分享页、临时登录链接或浏览器 blob: 地址。需要直接提交 Base64 参考图时,必须切换到 Gemini 原生格式,并使用 gemini-3.1-flash-image 或 gemini-3.0-pro-image;这两个名字不带 preview。

curl -X POST 'https://vip.zpika.com/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2.5-sunburst-2k",
    "prompt": "把花瓶改成钴蓝色陶瓷,保留形状、干花和背景",
    "images": ["https://example.com/reference.png"],
    "size": "1:1",
    "quality": "high",
    "output_format": "png",
    "n": 1,
    "async": true
  }'

编辑创建响应的 object 为 image.edit。保存返回的任务 ID,并使用下面的编辑查询路径:

curl --fail-with-body --silent --show-error \
  'https://vip.zpika.com/v1/images/edits/TASK_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'
参考图数量Gemini Preview、GPT 网页档、GPT Image 2 固定档及两个超分模型最多 9 张;GPT 2.5 / 2.6 带 K 的 Flare、Sunburst 最多 16 张。
协议不要混用OpenAI Images 使用 HTTPS URL 组成的 images 数组;Base64 的 inlineData 只属于 Gemini 原生格式。

蒙版局部编辑

蒙版能力以模型档案和当前 Key 的实际支持为准。Gemini 两条 Preview 模型档案支持 1 张 mask;本站已验证 gpt-image-2 可使用 OpenAI Images 编辑格式提交原图和 PNG 蒙版。其他模型未明确列出时,不要假设支持蒙版。

  • 蒙版与原图像素尺寸必须一致,并带 Alpha 透明通道。
  • 透明区域表示允许修改,不透明区域表示希望保留。
  • 蒙版是生成模型的语义约束,不是像素级锁定;同一主体的蒙版外区域仍可能被调整。
curl -X POST 'https://vip.zpika.com/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "只把蒙版区域内的车身改成绿色金属漆",
    "images": ["https://example.com/source.png"],
    "mask": "https://example.com/mask.png",
    "n": 1,
    "async": true
  }'

透明背景

GPT Image 2.6 的网页名、无 K 超分和带 K 档均支持 background: auto / opaque / transparent。透明背景必须把 output_format 设为 png 或 webp。

{
  "background": "transparent",
  "output_format": "png",
  "response_format": "url",
  "async": true
}

静图的 output_format 可用 png、jpeg、webp。JPEG 没有透明通道。

quality、清晰度与比例

!同一个字段在不同模型上含义不同不要把 Gemini 的 quality: "4k" 套到 GPT。GPT Image 2.6 的 web 名和两条无 K 超分都不要传 quality;只有带 K 的档位才用它控制质量。
模型类型清晰度怎么选quality本站计价
Gemini Preview同一模型内选择1k / 2k / 4k按 1K / 2K / 4K 三档
GPT 网页档模型最高约 1.5K不要传分辨率不改变表内单价
GPT Image 2.6 无 K Flare / Sunburst超分按自身尺寸出图,不套 K 档像素上限不要传按张,客户价格以站内实时目录为准
GPT Image 2 原生档由模型名 -1k/-2k/-4k 决定档案接受质量值,但本站价格不分 std/xhigh按模型名固定单价
GPT 2.5 Flare、Sunburst 原生档由模型名决定可选 low/medium/high/xhigh/max 五档low/medium/high 按 std;xhigh/max 按 xhigh
GPT 2.6 Flare、Sunburst 带 K 档由模型名决定low/medium/high/xhigh/max 五档low/medium/high 按 std;xhigh/max 按 xhigh

2.5 与 2.6 带 K 的 Flare / Sunburst 均支持五个质量值。无 K 的 2.6 三条模型不要传任何质量值。

比例与像素预算

带 K 型号的 1K / 2K / 4K 档位由模型名锁定,不能再用参数切换成另一个分辨率档。无限画布因此只提供画幅比例,不提供像素分辨率输入。直接调用 API 时,size 可使用比例;上游也接受符合下表预算的 宽x高,但它仍不能改变模型名已经确定的档位。不要另传 aspect_ratio。

原生档方图像素上限共同限制
1K1024×10241,048,576自定义宽高按 16 对齐;最长边 ≤3840;宽高比 ≤3:1;最少 655,360 像素
2K2048×20484,194,304
4K2880×28808,294,400

这张像素表只约束带 K 的公共名。4K 方图是 2880×2880,不是 4096×4096;无 K 的 gpt-image-2.6 web 出图及 Flare / Sunburst 超分不按这张 K 档像素表理解。

GPT Image 2.6 GIF / SVG

GIF 和 SVG 只使用 gpt-image-2.6,不能改用 Flare、Sunburst 或带 K 型号。两者仍走图片接口,不要提交到视频接口。

curl -X POST 'https://vip.zpika.com/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2.6",
    "prompt": "固定镜头下红色立方体缓慢旋转,无缝循环,无文字",
    "output_format": "gif",
    "response_format": "url",
    "async": true
  }'
  • frame_count 使用 2–16,默认 9。上游章节允许更大的 frame_duration_ms,但当前模型目录的兼容上限是 2000;本站接入请使用 20–2000 毫秒,默认 200。
  • GIF 模式下不要传蒙版;size 和 quality 不生效,成片尺寸由模型决定。
  • 图生 GIF / SVG 使用 /v1/images/edits,参考图写成 images: [{"image_url":"https://..."}],与静图的 URL 字符串数组不同;这里同样只接受 HTTPS URL。
  • 本页价格表是静态图片报价。GIF 属于新能力,实际可用模型与扣费以提交前的站内模型说明和使用日志为准。

SVG 示例

{
  "model": "gpt-image-2.6",
  "prompt": "白色画布中央的青绿色几何标志,使用清晰的矢量路径,无文字",
  "n": 1,
  "output_format": "svg",
  "response_format": "url",
  "async": true
}

客户价格

以下价格按本站“支付 ¥36 充值 $300 站内余额”换算,即:

人民币实际支付 = 站内余额扣除 × ¥0.12

均为单张静态图片的客户价格;当前列出的模型档案均要求 n: 1,一次请求生成一张。需要多张时由客户端分别提交多个独立请求。

Gemini Preview

模型参考图1K2K4K
gemini-3-pro-image-preview≤9$1.050 / ¥0.126$1.350 / ¥0.162$1.650 / ¥0.198
gemini-3.1-flash-image-preview≤9$0.900 / ¥0.108$1.200 / ¥0.144$1.500 / ¥0.180

GPT Image 网页档 · 最高约 1.5K

模型定位参考图任意支持比例 / 单张
gpt-image-2网页快速档 · 透明背景≤9$0.188 / 约 ¥0.023
gpt-image-2.5网页快速档 · 透明背景≤9$0.188 / 约 ¥0.023
gpt-image-2.5-flare网页 Flare · 透明背景≤9$0.313 / 约 ¥0.038
gpt-image-2.5-sunburst网页 Sunburst · 透明背景≤9$0.313 / 约 ¥0.038
gpt-image-2.6网页快速档 · 透明背景 · GIF≤9$0.188 / 约 ¥0.023

GPT Image 2.6 无 K 超分

模型定位参考图单张静态图
gpt-image-2.6-flare快速迭代、商品图与海报版式≤9以站内实时价格为准
gpt-image-2.6-sunburst细节与精确编辑≤9以站内实时价格为准

GPT Image 2 原生固定档

模型参考图质量计费余额 / 人民币
gpt-image-2-1k≤9固定价$0.750 / ¥0.090
gpt-image-2-2k≤9固定价$1.050 / ¥0.126
gpt-image-2-4k≤9固定价$2.700 / ¥0.324

GPT Image 2.5 原生 Flare / Sunburst

模型参考图std:low / medium / highxhigh:xhigh / max
gpt-image-2.5-flare-1k≤16$2.400 / ¥0.288$4.800 / ¥0.576
gpt-image-2.5-flare-2k≤16$2.700 / ¥0.324$5.400 / ¥0.648
gpt-image-2.5-flare-4k≤16$3.000 / ¥0.360$6.000 / ¥0.720
gpt-image-2.5-sunburst-1k≤16$2.700 / ¥0.324$5.400 / ¥0.648
gpt-image-2.5-sunburst-2k≤16$3.000 / ¥0.360$6.000 / ¥0.720
gpt-image-2.5-sunburst-4k≤16$3.300 / ¥0.396$6.600 / ¥0.792

GPT Image 2.6 原生 Flare / Sunburst

带 K 型号支持 low、medium、high、xhigh、max 五个质量值。前三档按 std 结算,后两档按 xhigh 结算。

模型参考图std:low / medium / highxhigh:xhigh / max
gpt-image-2.6-flare-1k≤16$2.400 / ¥0.288$4.800 / ¥0.576
gpt-image-2.6-flare-2k≤16$2.700 / ¥0.324$5.400 / ¥0.648
gpt-image-2.6-flare-4k≤16$3.000 / ¥0.360$6.000 / ¥0.720
gpt-image-2.6-sunburst-1k≤16$2.700 / ¥0.324$5.400 / ¥0.648
gpt-image-2.6-sunburst-2k≤16$3.000 / ¥0.360$6.000 / ¥0.720
gpt-image-2.6-sunburst-4k≤16$3.300 / ¥0.396$6.600 / ¥0.792
¥价格阅读方式例如 Flare 2K + quality: "high" 属于 std,约 ¥0.324/张;传 xhigh 或 max 属于 xhigh,约 ¥0.648/张。2.5 与 2.6 带 K 型号使用相同的质量分档规则。

常见问题

  • Gemini 请求 404 / 格式错误:先确认协议与模型名成对使用。OpenAI Images 使用带 preview 的模型名;Gemini 原生 Base64 参考图使用不带 preview 的模型名。
  • 无 K 模型参数错误:gpt-image-2.6、gpt-image-2.6-flare、gpt-image-2.6-sunburst 都不要传 quality;无 K 超分也不要套用 1K / 2K / 4K 像素上限。
  • 价格档不符合预期:2.5 与 2.6 带 K 型号的 low/medium/high 都按 std,xhigh/max 都按 xhigh。
  • 透明背景没有生效:确认模型属于网页档,使用 background: "transparent",并避免 JPEG。
  • 参考图读取失败:OpenAI Images 只接受无需登录即可直接下载的 HTTPS 图片 URL;没有图床时先通过无限画布上传。
  • 已有 Base64 参考图:不要塞进 OpenAI Images 的 images;改用 Gemini 原生路径、不带 preview 的模型名和 inlineData。
  • 请求超时或连接中断:异步模式先使用已保存的任务 ID继续查询;同步模式先到使用日志确认是否已有记录,再决定是否重新提交。
  • 内容审核拒绝:修改提示词或素材后再创建;原样重复通常无效。详见内容审查指南。

请求失败后的本站余额变化以使用日志为准。

交给 AI 的接入文档

使用自己的程序、工作流或画布时,可以把标准 Markdown 直接发给 AI 编程助手。它包含本站 Base URL、模型矩阵、同步响应格式、参考图、蒙版、尺寸和价格。

打开图片接口 AI 接入规范(Markdown) →

建议指令:默认实现 OpenAI Images + URL 参考图;只有明确需要 Base64 参考图时,才使用文档列出的 Gemini 原生协议和不带 preview 的模型名。