LoopToken
图片生成

GPT Image 系列

gpt-image-2、gpt-image-2-lite、gpt-image-2-ext、gpt-image-2.5-ext 同步文生图与编辑，按成功图片数计费

POST/v1/images/generations
POST/v1/images/edits

GPT Image 系列同步文生图与编辑，返回 OpenAI Images 格式。当前公开接口不包含 GPT Image 1 和 1.5。公共协议见图片生成总览。

项值
模型gpt-image-2、gpt-image-2-lite、gpt-image-2-ext、gpt-image-2.5-ext
模式同步，返回 OpenAI Images 格式
计费按成功图片数和分辨率档位，价格以定价页为准，见计费
媒体保留data[].url 为临时地址，请及时转存；data[].b64_json 由调用方保存

快速开始

curl https://api.vibelab.me/v1/images/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-lite",
    "prompt": "极简科技产品海报，白色背景",
    "size": "3:2",
    "resolution": "2k",
    "n": 1
  }'
{
  "created": 1788012156,
  "data": [{"b64_json": "iVBORw0KGgo..."}],
  "size": "2048x1152",
  "model": "gpt-image-2-lite"
}

gpt-image-2-lite 固定使用 data[].b64_json，output_format 为 png，顶层 size 是最终像素尺寸（例如 2048x1152）。

模式选择

模型能力说明
gpt-image-2 / gpt-image-2-lite文生图、参考图生成1K、2K、4K 三档；gpt-image-2-lite 按所选比例和分辨率输出 PNG；gpt-image-2-lite 只在 /v1/images/generations 提供，n 为 1–10
gpt-image-2-ext文生图、单图编辑通过外部 OpenAI Images 兼容线路；每次固定 1 张；编辑走 /v1/images/edits（multipart，单数 image 字段）
gpt-image-2.5-ext文生图、参考图生成只支持 /v1/images/generations（参考图通过 image_urls 传入）；n 必须为 1；不支持 /v1/images/edits；输出与 gpt-image-2-lite 一致

请求参数

参数类型必填默认说明
modelstring是-gpt-image-2 / gpt-image-2-lite / gpt-image-2-ext / gpt-image-2.5-ext
promptstring是-提示词
ninteger否1图片数量；gpt-image-2-lite 为 1–10；gpt-image-2-ext、gpt-image-2.5-ext 固定为 1
sizestring否1:1支持 auto 及常见横竖宽高比
resolutionstring否1k1k / 2k / 4k
image_urlsstring[]否-参考图，元素须为非空字符串（gpt-image-2-lite、gpt-image-2.5-ext 校验）
versionstring否flare仅 gpt-image-2.5-ext：规格，flare / sunburst
quality、output_formatstring否-仅 gpt-image-2-ext 使用，见请求示例

最终像素尺寸

gpt-image-2-lite 与 gpt-image-2.5-ext 支持的最终像素尺寸如下：

size1k2k4k
1:1 / auto1024x10242048x20482880x2880
3:21536x10242048x13603520x2336
2:31024x15361360x20482336x3520
4:31024x7682048x15363312x2480
3:4768x10241536x20482480x3312
5:41280x10242560x20483216x2576
4:51024x12802048x25602576x3216
16:91536x8642048x11523840x2160
9:16864x15361152x20482160x3840
2:12048x10242688x13443840x1920
1:21024x20481344x26881920x3840
3:11536x5123072x10243840x1280
1:3512x15361024x30721280x3840
21:92016x8642688x11523840x1648
9:21864x20161152x26881648x3840

请求示例

GPT Image 2 Ext 文生图

JSON 请求，公共参数与其他 GPT Image 2 版本一致。平台调用外部线路时，把 size 宽高比和 resolution 档位转换为上表中的明确像素尺寸，例如 16:9 + 2k 转换为 2048x1152。已经使用 <宽>x<高> 的 size 原样转发。

curl https://api.vibelab.me/v1/images/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-ext",
    "prompt": "极简科技产品海报，白色背景",
    "size": "16:9",
    "resolution": "2k",
    "quality": "low",
    "output_format": "png",
    "n": 1
  }'

GPT Image 2 Ext 单图编辑

发送到 POST /v1/images/edits，Content-Type 由 curl 自动生成。仅支持一个单数 image 文件字段；image[] 和多图编辑不属于公开契约。

curl https://api.vibelab.me/v1/images/edits \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -F "model=gpt-image-2-ext" \
  -F "prompt=把红色方块改成蓝色，保留构图和背景" \
  -F "image=@./input.png" \
  -F "size=1536x1024" \
  -F "quality=low" \
  -F "n=1"

GPT Image 2.5 Ext 文生图

JSON 文生图请求，可通过 image_urls 传入参考图，n 固定为 1。version 选择规格：flare（默认）或 sunburst，两种规格价格相同；传入其他值返回 400。size 与 resolution 取值见上方尺寸表。响应为同步 OpenAI Images 格式：data[].b64_json 为 PNG，顶层 size 是最终像素尺寸，model 为 gpt-image-2.5-ext。

curl https://api.vibelab.me/v1/images/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-ext",
    "prompt": "极简科技产品海报，白色背景",
    "size": "16:9",
    "resolution": "2k",
    "version": "sunburst",
    "n": 1
  }'

响应

OpenAI Images 格式的 data[]：gpt-image-2-lite、gpt-image-2.5-ext 固定返回 data[].b64_json（PNG），顶层 size 为最终像素尺寸；gpt-image-2-ext 返回 data[].url 或 data[].b64_json，gpt-image-2 同为 data[]。必须按返回图片的真实 MIME 类型和像素尺寸处理，见图片生成总览。

计费

按成功图片数和分辨率档位计价，价格见定价页。

  • gpt-image-2-ext 的销售价格固定为线上 gpt-image-2 对应档位的 8 折。LoopToken 按成功图片数结算，不使用外部线路返回的 usage token 字段（可能全部为 0）。
  • gpt-image-2.5-ext：flare 与 sunburst 同价。
gpt-image-2.5-ext 分辨率价格（积分/张）
1k0.10625
2k0.175
4k0.2625

错误

HTTPcode触发场景处理
400invalid_requestgpt-image-2-lite / gpt-image-2.5-ext 请求了 /v1/images/edits（... is only available on /v1/images/generations）改用 /v1/images/generations
400invalid_requestprompt required（gpt-image-2-lite / gpt-image-2.5-ext 提示词为空）填写提示词
400invalid_requestn must be between 1 and 10 for gpt-image-2-liten 取 1–10
400invalid_requestgpt-image-2.5-ext only supports n=1 / gpt-image-2-ext only supports n=1n 传 1
400invalid_requestversion must be flare or sunburst for gpt-image-2.5-extversion 取 flare 或 sunburst
400invalid_requestunsupported size "..." for ... / unsupported resolution "..." for ...使用尺寸表内的比例与档位
400invalid_requestimage_urls must be an array of strings / image_urls cannot contain empty values传非空字符串数组
400invalid_requestgpt-image-2-ext edits require multipart/form-data；multipart/form-data is only supported for gpt-image-2-ext editsgpt-image-2-ext 编辑用 multipart，其余模型用 JSON
400invalid_requestgpt-image-2-ext edits require exactly one image / gpt-image-2-ext edits require the singular image field只传一个单数 image 文件字段

其余错误见图片生成总览。

注意事项

gpt-image-2-ext 只承诺当前已验证的部分兼容能力。外部线路可能只保持自定义尺寸的宽高比，且可能忽略 JPEG、WebP 和压缩率参数。客户端必须按返回文件的真实 MIME 类型和像素尺寸处理，不能根据请求参数推断结果格式或尺寸。

  • gpt-image-2-ext 当前实测可靠的输出是 1536x1024 PNG → 仍须读取实际返回图片。
  • quality=low 会被线路接受，但响应不回显实际上游质量档位 → 不要依赖响应判断质量档位。
  • gpt-image-2-ext 编辑使用 image[] 或多图 → 不属于公开契约，只用单数 image。

Nano Banana 系列

nano-banana、nano-banana-pro、nano-banana-2、nano-banana-2-lite、nano-banana-2.1 图片生成与参考图编辑，同步返回 OpenAI Images 格式

GPT Image 2 Official

gpt-image-2-official 文生图、图生图、局部重绘，同步，按 token 计费

本页内容

快速开始模式选择请求参数最终像素尺寸请求示例GPT Image 2 Ext 文生图GPT Image 2 Ext 单图编辑GPT Image 2.5 Ext 文生图响应计费错误注意事项