先选择接入路径
| 用途 | 方法与路径 | 说明 |
|---|---|---|
| 文生图 | POST /v1/images/generations | JSON 请求,默认传 async: true 后轮询结果 |
| 参考图 / 编辑(主推) | POST /v1/images/edits | OpenAI Images JSON;参考图仅支持公网 HTTPS URL |
| Base64 参考图(例外) | POST /v1beta/models/{model}:generateContent | Gemini 原生格式;仅使用不带 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 参考图。
模型怎么选
OpenAI Images 格式:gemini-3.1-flash-image-preview
Gemini 原生格式:gemini-3.1-flash-image
速度和性价比优先;OpenAI 格式使用 URL 参考图,原生格式可直接提交 Base64。
OpenAI Images 格式:gemini-3-pro-image-preview
Gemini 原生格式:gemini-3.0-pro-image
复杂构图、多图融合和质量优先;OpenAI 格式使用 URL 参考图,原生格式可直接提交 Base64。
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-1k gpt-image-2-2k gpt-image-2-4kAdobe 原生高速渠道,模型名直接锁定像素档,最多 9 张参考图,本站按固定单价结算。
gpt-image-2.5/2.6-flare-{1k|2k|4k}更快的日常高质量出图,适合新图、商品图、海报和批量试稿,最多 16 张参考图,支持五档 quality。
gpt-image-2.5/2.6-sunburst-{1k|2k|4k}细节和精确编辑优先,适合参考图局部修改与多轮迭代,最多 16 张参考图,支持五档 quality。
| 画布基础系列 | 可选档位 | 最终请求模型 |
|---|---|---|
gpt-image-2.6 | Web(最高约 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。data[].url,并尽快下载或转存。async: 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'
参考图、编辑与蒙版
images 数组中的每一项都必须是服务端无需登录即可读取的公网 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'
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、清晰度与比例
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。
| 原生档 | 方图 | 像素上限 | 共同限制 |
|---|---|---|---|
| 1K | 1024×1024 | 1,048,576 | 自定义宽高按 16 对齐;最长边 ≤3840;宽高比 ≤3:1;最少 655,360 像素 |
| 2K | 2048×2048 | 4,194,304 | |
| 4K | 2880×2880 | 8,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
| 模型 | 参考图 | 1K | 2K | 4K |
|---|---|---|---|---|
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 / high | xhigh: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 / high | xhigh: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 |
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、模型矩阵、同步响应格式、参考图、蒙版、尺寸和价格。
建议指令:默认实现 OpenAI Images + URL 参考图;只有明确需要 Base64 参考图时,才使用文档列出的 Gemini 原生协议和不带 preview 的模型名。