模型 API 目录（含官方/标准）▾

图像系列

POST [标准] GPT-Image-2 图像生成 POST [官方] GPT-Image-2 官方渠道图像生成

视频系列

[官方] = 官方上游渠道；[标准] = 经济路由。同族可展开切换对比。

API 手册/图像系列/GPT-Image-2 官方渠道图像生成

POST官方渠道图像

GPT-Image-2 官方渠道图像生成

model = gpt-image-2-official·¥0.48/张

OpenAI 官方渠道 gpt-image-2，基于 Images 兼容协议
异步处理模式，返回 task_id 用于后续查询
文生图 / 图生图；质量、尺寸参数更贴近官方
支持 quality 档位；单次可多张（见 n）
参考图最多以 schema 上限为准
人民币计费：售价 ¥0.48/张（通常高于标准渠道）；失败自动退款

POST /api/v1/images/generations

模型页试一试 →

官方渠道 vs 标准渠道

本页为「官方渠道」，单价更高、参数更接近 OpenAI 官方。只要便宜、异步出图够用，请改用同族「GPT-Image-2 图像生成」（gpt-image-2）。

模型名

请求体 model 固定填写 gpt-image-2-official。

同族渠道

同一模型族下的官方 / 标准渠道，参数与单价可能不同，请按业务选择。

POST GPT-Image-2 图像生成[标准渠道]

Authorizations

需要 Bearer Token。在 API Key 管理创建后，请求头加入：

Authorization: Bearer cr_你的API_Key

Base URL：https://xiaoguai123.xyz

Body

图像生成模型名称

固定填写 gpt-image-2-official（OpenAI 官方渠道）

图像生成的文本描述

支持中英文，建议详细描述
提交前会经过平台敏感词 / 安全审核

画面尺寸 / 比例

可为像素串（如 1024x1024）或比例，视上游接受范围
也支持直接传入像素尺寸字符串

尺寸 × 分辨率参考映射

官方渠道亦可按比例×档位理解像素；下表供选型参考

size	1K	2K	4K
1:1	1024×1024 / 1254×1254	2048×2048	2880×2880
3:2	1536×1024	2048×1360	3520×2336
2:3	1024×1536	1360×2048	2336×3520
4:3	1024×768	2048×1536	3312×2480
3:4	768×1024	1536×2048	2480×3312
5:4	1280×1024 / 1448×1086	2560×2048	3216×2576
4:5	1024×1280 / 1122×1402	2048×2560	2576×3216
16:9	1536×864 / 1672×941	2048×1152	3840×2160
9:16	864×1536 / 941×1672	1152×2048	2160×3840
2:1	2048×1024 / 1774×887	2688×1344	3840×1920
1:2	1024×2048 / 887×1774	1344×2688	1920×3840
3:1	1881×836 / 1536×512	3072×1024	3840×1280
1:3	887×1774 / 512×1536	1024×3072	1280×3840
21:9	2016×864 / 1915×821	2688×1152	3840×1648
9:21	864×2016 / 821×1915	1152×2688	1648×3840

使用场景示例

文生图（最简请求）

{
  "model": "gpt-image-2-official",
  "prompt": "星空下的古老城堡"
}

高质量海报

{
  "model": "gpt-image-2-official",
  "prompt": "赛博朋克夜景",
  "size": "1024x1024",
  "quality": "high",
  "n": 1
}

图生图（多参考图）

{
  "model": "gpt-image-2-official",
  "prompt": "将两张参考图融合成一张插画海报",
  "quality": "high",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ]
}

多张生成（n > 1）

{
  "model": "gpt-image-2-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1024x1024",
  "quality": "low",
  "n": 4
}

Response

提交成功时返回任务数组：

status：如 submitted（已提交）
task_id：任务唯一标识，用于后续查询

查询任务结果

GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
Authorization: Bearer cr_你的API_Key

• 提交成功返回 task_id，轮询任务接口取结果

• 官方渠道耗时可能更长，请适当加大轮询间隔

详见任务查询接口。

状态	含义
pending / submitted	已提交或排队
processing	上游处理中
completed	成功，result 可用
failed	失败，已自动退款

REQUEST

curl -X POST https://xiaoguai123.xyz/api/v1/images/generations \
  -H "Authorization: Bearer cr_你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "gpt-image-2-official", "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感", "size": "1024x1024", "resolution": "1K", "quality": "auto" }'

RESPONSE

成功提交

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "xg_01hxyz..."
    }
  ]
}

GPT-Image-2 官方渠道 图像生成