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

图像系列

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

视频系列

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

API 手册/图像系列/GPT-Image-2 图像生成

POST标准渠道图像

GPT-Image-2 图像生成

model = gpt-image-2·¥0.10/张

异步处理模式，返回任务 ID 用于后续查询
基于 OpenAI Images 兼容协议，支持文生图 / 图生图
支持多种图片比例，通过 size 字段传入
通过 resolution（1K / 2K / 4K）控制实际输出像素档位
参考图支持 URL 与 base64 Data URI（上限见参数）
人民币按次计费：售价 ¥0.10/张；失败/超时自动退款

POST /api/v1/images/generations

模型页试一试 →

渠道说明

本页为「标准渠道」（经济路由）。若需要 OpenAI 官方渠道能力（更多质量/格式参数、更高单价），请使用同族「GPT-Image-2 官方渠道」。

模型名

请求体 model 固定填写 gpt-image-2。上游可能存在别名兼容，以本站模型广场启用的 publicId 为准。

同族渠道

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

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

Authorizations

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

Authorization: Bearer cr_你的API_Key

Base URL：https://xiaoguai123.xyz

Body

图像生成模型名称

固定填写 gpt-image-2

图像生成的文本描述

支持中英文，建议详细描述
提交前会经过平台敏感词 / 安全审核，命中违规内容会直接返回错误

生成图片张数

取值以模型参数为准（本站当前 schema 限制见下表默认）
必须传入纯数字，不要加引号

尺寸 × 分辨率映射表

size × resolution → 实际像素（对标常见 OpenAI Images 映射；上游可能做 16 倍数近似）

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",
  "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格"
}

文生图（指定比例 + 2K）

{
  "model": "gpt-image-2",
  "prompt": "a corgi astronaut on the moon, cinematic, 8k",
  "size": "16:9",
  "resolution": "2K"
}

文生图（4K 输出）

{
  "model": "gpt-image-2",
  "prompt": "星空下的古老城堡",
  "size": "16:9",
  "resolution": "4K"
}

图生图（参考图 = URL）

{
  "model": "gpt-image-2",
  "prompt": "把这张照片变成水彩画风格",
  "image_urls": [
    "https://example.com/photo.jpg"
  ]
}

图生图（参考图 = base64）

{
  "model": "gpt-image-2",
  "prompt": "把这张照片变成水彩画风格",
  "image_urls": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ]
}

图生图（多参考图融合）

{
  "model": "gpt-image-2",
  "prompt": "把两张照片融合成一张海报",
  "size": "4:3",
  "resolution": "2K",
  "image_urls": [
    "https://example.com/photo-a.jpg",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ]
}

Response

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

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

查询任务结果

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

• 提交成功返回 `task_id`，再 `GET /api/v1/tasks/{task_id}` 轮询

• 完成后从 `data.result.images` 取 URL 数组

• 失败状态会自动退款解冻

详见任务查询接口。

状态	含义
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", "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感", "size": "1:1", "resolution": "1K" }'

RESPONSE

成功提交

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