ModelRouterModelRouter
⚠️合规提示:本项目仅用于合法授权的 API 网关、内部管理和私有化部署场景。请遵守上游服务条款、平台规则、监管要求和内容安全要求。
接口调用图片模型

GPT Image 2

OpenAI 生图模型,细节和文字渲染出色。

出图较慢,1024 尺寸通常需要 1–2 分钟。

  • 模型 ID:gpt-image-2
  • 接口:POST https://modelrouter.club/v1/images/generations(文生图)、POST https://modelrouter.club/v1/images/edits(图片编辑),同步返回
  • 查看价格 · 在线试用(登录后,按自己的余额扣费)

请求参数

Authorizationstring必填

Bearer YOUR_API_KEY,在 控制台的 API 密钥页 创建。

modelstring必填

gpt-image-2

promptstring必填

画面描述。

sizestring

输出尺寸,格式为 宽x高,如 1024x1024、1536x1024、1024x1536。尺寸越大,消耗的 token 越多。

qualitystring

画质:low、medium、high。画质越高越贵、越慢。

output_formatstring

png 或 jpeg。

imagefile

仅图片编辑(/v1/images/edits)使用。multipart 方式上传本地图片文件;也可以用 JSON 方式传 images: [{"image_url": "图片 URL"}]。

示例:文生图

curl https://modelrouter.club/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "秋日咖啡店的拿铁海报,暖色调,留出标题位置",
    "size": "1024x1024",
    "quality": "low"
  }'

示例:图片编辑

图片编辑走 /v1/images/edits,有两种传图方式。

curl https://modelrouter.club/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F model=gpt-image-2 \
  -F 'prompt=给这只柴犬戴上一条红色围巾,其余保持不变' \
  -F image=@shiba.png \
  -F quality=low \
  -F size=1024x1024
curl https://modelrouter.club/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "给这只柴犬戴上一条红色围巾,其余保持不变",
    "images": [{ "image_url": "https://example.com/shiba.png" }],
    "quality": "low",
    "size": "1024x1024"
  }'
from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://modelrouter.club/v1", timeout=300)

result = client.images.edit(
    model="gpt-image-2",
    image=open("shiba.png", "rb"),
    prompt="给这只柴犬戴上一条红色围巾,其余保持不变",
    quality="low",
    size="1024x1024",
)
print(result.data[0].url)
说明
JSON 方式必须用 images 数组,写成 "image": "URL" 会被拒绝(400)。

响应

示例结构:

{
  "data": [
    { "url": "https://example.com/generated/xxxx.png" }
  ]
}

GPT Image 实测返回 url,同时带一个空的 b64_json 字段;读取时取非空的那个。响应里还有 usage,列出本次输入、输出的 token 数。

计费

按 token 计费,包括输入文本、输入图片和输出图片的 token;尺寸越大、画质越高越贵。参考:1024 低画质约 ¥0.03 / 张,中画质约 ¥0.06 / 张。图片编辑还要计输入图片的 token,带一张 1024 参考图、低画质约 ¥0.07 / 张。

注意
  • Nano Banana 与可灵的参考图只接受公网可访问的 http(s) URL,不支持上传文件或 Base64。
  • 生成结果是临时链接:GPT Image 约 24 小时失效,Nano Banana 与可灵约 7 天失效。请及时下载转存。
  • 接口同步返回,出图可能需要 1–2 分钟,请把客户端超时设为 5 分钟以上,避免重复提交导致重复扣费。

实时单价见 模型广场。通用字段、响应格式和常见错误见 图片通用说明。