跳转到主要内容
POST
使用 gpt-image-2.6-ext,通过 version 选择 flare 或 sunburst,按张固定价计费。resolution 支持 1k / 2k / 4k,当前请使用 n: 1,所有质量档位及 PNG / JPEG / WebP / SVG / GIF 均可用。
本页是 Ext 接口,模型名与参数规则不同于 GPT-Image-2.6 按 token 计费版本。

认证

string
必填
使用平台 API Key 进行 Bearer Token 认证,在 API Key 管理页面 获取密钥。提交请求使用 Content-Type: application/json。

版本选择

请求参数

枚举值不区分大小写,首尾空格会被去掉;示例统一使用小写。
string
必填
固定为 gpt-image-2.6-ext。
string
必填
生成或编辑提示词,必填且不能为空。多图编辑时可用“第一张图”“第二张图”指代素材,并说明要修改和保留的内容。
string
默认值:"flare"
flare / sunburst;省略使用 flare。其他值返回 HTTP 400。两个版本的价格可能不同。
string
默认值:"1k"
1k / 2k / 4k(也接受大写 1K / 2K / 4K)。与 size 比例配合决定输出像素,见下方「比例与像素」表。单张价格随档位变化;其他值如 hd / 8k 返回 HTTP 400。
string
默认值:"auto"
只接受 auto 或下表的 10 种比例,不接受 1024x1024 等像素值。auto 文生图为 1:1;图生图按第一张能读取宽高的参考图,匹配最接近的支持比例。GIF 请省略此字段或传 auto。
string
size 的同义字段,二选一即可。同时传入时必须相同,否则返回 HTTP 400。GIF 同样只能省略或传 auto。
integer
默认值:"1"
当前请使用整数 1。
string
auto / low / medium / high / xhigh / max。省略时不下发,由上游自动选择;auto 也不固定为 low。质量不影响单张价格,高档位通常耗时更长。其他值返回 HTTP 400。
string
默认值:"png"
png / jpeg / webp / svg / gif;jpg 是 jpeg 的别名。SVG、GIF 仅支持文生图。其他格式返回 HTTP 400。
暂不支持 SVG 输出。
string
low / medium / high,省略时不下发,由上游决定。用于控制画面复杂度;low 适合简洁图标和扁平插画,high 适合丰富细节。不影响单张价格。
string[]
最多 16 张,每张不超过 20 MB,支持 PNG / JPEG / WebP / GIF / BMP。可传公网 HTTP(S) URL 或图片 Base64 Data URL,例如 data:image/png;base64,...。传入后为图生图;SVG、GIF 不能带参考图。
resolution 为 2k / 4k 时,参考图不能是 GIF / BMP。
兼容字段名 image_url、image、images、input_image、input_images,建议统一使用 image_urls。URL 需要能从公网直接访问,无需登录。

比例与像素

auto 文生图为 1:1,即 1k 1024×1024、2k 2048×2048、4k 2880×2880;图生图匹配上表中的最接近比例,不保证与原图像素尺寸完全一致。

参考图编辑示例

参考图也通过 POST /v1/images/generations 提交。请将示例 URL 替换为真实可访问的图片链接。

SVG 矢量图

设置 output_format: "svg",仅支持文生图且 n=1。size 可使用比例名;complexity: "low" 适合简洁矢量图形。
object
可选的 SVG 编写模型配置,仅能用于 SVG 输出。整个对象可以省略,编写 SVG 的文本模型不另收费。

GIF 动图

设置 output_format: "gif",仅支持文生图。省略 size / aspect_ratio 或传 auto,传比例名或像素值会返回 HTTP 400。请在提示词中描述动作及循环方式。

不支持与不生效的参数

提交与查询结果

提交成功为 HTTP 200,从 data[0].task_id 取任务号。通过 任务查询接口 每 3–5 秒查询一次,直到 completed 或 failed。客户端等待超时后继续查询已有任务,避免重复提交生成请求。
下面展示查询结果中的任务对象;若响应使用 {code, data} 包装,先读取 data。右侧 Python / JavaScript 示例兼容两种读取方式。
result.images[0].url 是链接数组,首个链接为 result.images[0].url[0]。请在 expires_at 指示的时间前下载保存;建议有效期为任务完成后 24 小时。cost / credits_cost 表示最终扣费。 批量查询使用 POST /v1/tasks/batch,请求体为 {"task_ids":["task_xxx","task_yyy"]}。

计费

单张价格只由 version × resolution 决定;quality、格式(包括 SVG / GIF)、complexity、比例、参考图数量及 svg.model 均不影响价格。当前使用 n=1,失败任务全额退款。实际价格以 APIMart 价格页面 或 /api/pricing 为准。

错误处理