Models Hub
API 参考图片系列

图像生成调用指南

GPT Image 2.5 Sunburst / Flare、gpt-image-2 与 Gemini 绘图模型的调用示例。

编辑此页

modelsok 提供多款 AI 绘图模型。基础地址 https://modelsok.com，使用 Authorization: Bearer <API Key> 鉴权。本页说明各模型的调用方式与实用建议。

可用模型

模型说明调用方式
gpt-image-2.5-sunburst文生图，已验证 1024×1024 PNG 输出OpenAI 兼容接口
gpt-image-2.5-flare文生图，已验证 1024×1024 PNG 输出OpenAI 兼容接口
gpt-image-2OpenAI 图像模型，输出尺寸与请求完全一致，最高 3840×2160OpenAI 兼容接口
gemini-2.5-flash-image-previewGemini 快速绘图OpenAI 兼容接口 / Gemini 原生
gemini-2.5-flash-imageGemini 快速绘图Gemini 原生
gemini-3.1-flash-image-previewGemini 快速绘图Gemini 原生
gemini-3-pro-image-previewGemini 高质量绘图Gemini 原生

GPT Image 2.5：Sunburst / Flare

两个模型使用相同的接口和鉴权方式，切换时仅需更换 model。2026-09-09 已分别验证两个服务渠道的文生图请求；以下为已验证的最小参数组合。模型可见性与价格以账号的模型广场为准。

curl --max-time 300 https://modelsok.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "蓝色背景，一只橙色陶瓷机器人手捧向日葵，产品摄影风格",
    "n": 1,
    "size": "1024x1024"
  }'

使用 Flare 时，将 model 改为 gpt-image-2.5-flare。同步响应的 data[0].b64_json 为 Base64 图像数据，解码后可保存为 PNG；示例不传 response_format 或 quality。

推荐异步提交，避免长连接超时

在上述 URL 后添加 ?async=true，提交成功即返回任务 id。使用同一把 API Key 轮询：

当前网关存在一个已知限制：开启了“模型限制”的 API Key 可能在查询任务时收到 403“该令牌无权访问模型”，即使生成已成功。此类密钥请先使用同步示例；不要因此关闭正式密钥的权限限制，也不要重复提交已经创建的任务。该问题不是模型生成失败。

curl "https://modelsok.com/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

每隔 3–5 秒查询一次。state 为 queued / processing 时继续等待，为 succeeded 时读取 data.images 的图片结果，为 failed 时检查错误详情。异步结果与同步的 data[].b64_json 结构不同。保存任务 ID 后，即使查询超时也应继续查询原任务，避免重复提交产生重复费用。

如果 data.images[].url 是相对路径（例如 /api/relay-temp-images/…png），请先与 https://modelsok.com 拼接再下载。请及时下载保存图片，临时图片链接不是永久存储。

客户端超时设为 300 秒并不能延长 CDN 的等待上限；遇到 524 时优先采用异步方式。

目前已验证的是单张 1024×1024 文生图。其他分辨率、画质档位、图像编辑以及两个型号的性能差异尚未在本指南中验证；下方 gpt-image-2 的尺寸上限、默认画质和价格倍率不适用于推断这两个新模型。

gpt-image-2

尺寸规则

输出尺寸严格等于请求的 size。size 需同时满足三个条件，否则接口会明确报错（不会静默返回其它尺寸）：

条件不满足时的报错
宽、高都必须是 16 的倍数Width and height must both be divisible by 16
总像素在 655,360 ~ 8,294,400 之间below / exceeds the current pixel budget
最长边 ≤ 3840The longest edge must be less than or equal to 3840

常用尺寸参考：

比例可用 size
1:11024x1024、2048x2048
4:3 / 3:41024x768、2048x1536 / 768x1024、1536x2048
3:2 / 2:31536x1024 / 1024x1536
5:4 / 4:51280x1024 / 1024x1280
16:9 / 9:162048x1152、3840x2160 / 1152x2048、2160x3840
21:92688x1152

4096x4096 超出最长边限制会被拒绝。需要 4K 请使用 3840x2160。

画质档位

可选参数 quality，取值 low / medium / high，不传时默认为 low。档位同时影响画质、耗时与价格，建议按用途显式指定。

quality相对价格生成耗时（1024×1024）建议用途
low（默认）1×约 26 秒草稿、批量预览
medium约 9×约 43 秒日常成品
high约 36×约 109 秒最终交付

文生图

curl https://modelsok.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只吃竹子的小熊猫，扁平矢量风格",
    "size": "1024x1024",
    "quality": "medium"
  }'

图生图 / 图像编辑

通过 image 字段传入公网可访问的图片 URL即可，无需上传文件；传数组可提交多张参考图（最多 16 张）。

curl https://modelsok.com/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "把杯身换成哑光黑，保持构图不变",
    "image": "https://你的图床/reference.png",
    "size": "3840x2160",
    "quality": "medium"
  }'

gpt-image-2 不接受 response_format 参数，传入会返回 400 Unknown parameter: 'response_format'。 结果固定以 b64_json（Base64 图像数据）返回。

返回示例：

{
  "created": 1780888000,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }]
}

Python 示例

import base64, requests

resp = requests.post(
    "https://modelsok.com/v1/images/edits",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "gpt-image-2",
        "prompt": "一只吃竹子的小熊猫，扁平矢量风格",
        "image": "https://你的图床/reference.png",
        "size": "2048x2048",
        "quality": "medium",
    },
    timeout=300,
)
data = resp.json()["data"][0]["b64_json"]
open("out.png", "wb").write(base64.b64decode(data))

图生图单次耗时通常 20–110 秒（随 quality 上升），建议客户端超时不低于 300 秒并做好重试。

Gemini 系列

方式一：OpenAI 兼容接口

适用于 gemini-2.5-flash-image-preview。

curl https://modelsok.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "一只吃竹子的小熊猫，扁平矢量风格",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

建议使用 response_format: "b64_json"。默认 url 返回的是对象存储上的临时链接，可能在一段时间后失效、且偶有下载超时。用 b64_json 直接拿到图像数据，集成更稳定。该参数仅 Gemini 系列可用，gpt-image-2 不支持。

方式二：Gemini 原生接口

适用于全部 Gemini 绘图模型。注意路径带尾部斜杠。

curl "https://modelsok.com/v1beta/models/gemini-2.5-flash-image:generateContent/" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "一只蓝色卡通猫，白色背景" }] }]
  }'

注意：Gemini 原生接口返回的图片通常以 Markdown 图片链接的形式包含在文本里（位于 candidates[0].content.parts[].text，形如 ![image](https://...)），而非 inlineData。集成时需从文本中提取该 URL 再下载。如需直接拿到标准图像数据，请改用 gemini-2.5-flash-image-preview 的 OpenAI 兼容接口。

返回示例：

{
  "candidates": [{
    "content": {
      "role": "model",
      "parts": [{ "text": "![image](https://.../xxxx.png)" }]
    }
  }]
}

计费

gpt-image-2 按 token 用量计费，费用由输出尺寸（size）、画质档位（quality）和参考图尺寸共同决定——出图越大、档位越高，费用越高。其余绘图模型按次计费（每次生成扣固定额度）。

具体单价以「模型广场」展示为准，价格随账号等级不同。

原生 OpenAI 格式

OpenAI Completions 兼容的文本补全接口。

生成图像

OpenAI Images API 兼容的图像生成接口。

本页目录

可用模型GPT Image 2.5：Sunburst / Flare推荐异步提交，避免长连接超时gpt-image-2尺寸规则画质档位文生图图生图 / 图像编辑Python 示例Gemini 系列方式一：OpenAI 兼容接口方式二：Gemini 原生接口计费