GPT Image 2 图片生成 API

通过 OpenAI 兼容 Images API 使用 gpt-image-2 生成 PNG。第一阶段每次只生成一张，支持中等或高画质、签名 URL 或 base64 输出，以及可选 SSE。

选择入口和模式

• 可能耗时数分钟的普通同步 JSON 请求使用 https://origin.modelflare.dev/v1。
• 经 Cloudflare 的长请求使用 https://modelflare.dev/v1 并设置 stream=true。最终图片就绪前，Modelflare 会发送仅用于传输保活的 SSE 心跳。
• 不要在请求进行中跨域重定向 POST；提交前先选定 Base URL。

同步请求

curl https://origin.modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "黎明时安静的湖畔木屋，电影感自然光",
    "n": 1,
    "quality": "medium",
    "size": "1024x1024",
    "response_format": "url",
    "output_format": "png"
  }'

URL 响应包含一个一小时后过期的 Modelflare 私有签名链接：

{"created":1710000000,"data":[{"url":"https://modelflare.dev/v1/images/assets/.../content?expires=...&signature=..."}]}

将 response_format 设为 b64_json，可直接获得验证后的 PNG，而不持久化 API 输出对象。

实时模型与价格页面会展示常用尺寸的 medium 与 high 价格点。计费以请求中的实际画质和尺寸为准，不叠加普通路由分组倍率，最终费用会写入用量日志。

流式请求

curl -N https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"一只白猫在雨中的霓虹街道上奔跑","n":1,"quality":"high","size":"1024x1024","response_format":"url","stream":true}'

SSE 注释只是心跳，不代表模型已经输出。收到 image_generation.completed 和 data: [DONE] 后结束。

支持字段

• model：必填，只能是 gpt-image-2。
• prompt：必填，最多 32,000 个 Unicode 字符。
• n：可选，目前只能是 1。
• quality：medium（默认）或 high。
• size：WIDTHxHEIGHT，宽高均为 16 的倍数，最大边 3840 px，宽高比不超过 3:1，总像素 0.66–8.29 MP。
• response_format：url（默认）或 b64_json。
• output_format：目前只支持 png。
• stream：可选布尔值。

图片编辑、变体、参考图、局部图和未知字段都会被拒绝。上游、校验、下载或存储失败不会伪装成成功图片，预扣 Credits 通过按 Request ID 幂等的退款路径返还。

请使用普通 API Key。绑定特定渠道的 Key 会被拒绝；启用了模型限制的 Key 必须包含 gpt-image-2。