参考文档v1.0.0 稳定版本

AI Image 2 API

接入 GPT Image 2.0 图像生成与参考图编辑能力。本文档涵盖身份验证、生成与状态查询接口、请求限制和计费说明。

https://gptimage2-ai.com

快速上手

仅需两个步骤即可完成你的第一次 API 调用：提交生成任务，然后轮询查询任务状态。

提交任务

向生成接口发送 POST 请求以获取 Task ID。

查询状态

使用 Task ID 检查进度，直到获取图片 URL。

身份验证

注意：请妥善保管 API Key，不要在客户端代码中暴露。

HTTP Header

Authorization: Bearer {YOUR_API_KEY}

POST

https://gptimage2-ai.com/api/generate

创建新的图像生成或参考图编辑任务。此接口为异步调用，将立即返回 task_id 与任务初始状态；请调用 /api/status 来获取最终生成的图片。

此接口会立即返回 task_id；请轮询 /api/status，直到任务状态为 SUCCESS 来获取图像 URL。

请求体参数

参数名称	类型	必填	描述
`prompt`	string	条件必填	描述所需图像的文本提示（最多 20000 字符）。未传 images 时必填。
`images`	string[]	否	可选的参考图 URL 数组，用于在纯文生图之外进行编辑或重组。
`aspect_ratio`	string	否	输出宽高比。可选值：auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4, 2:3。
`resolution`	string	否	输出分辨率：1K（默认）、2K 或 4K。5:4 与 4:5 仅支持 1K；1:1 不支持 4K。

返回示例（JSON）

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://gptimage2-ai.com/api/status

查询任务执行状态与生成结果。

查询参数

参数名称	必填	描述
`task_id`	是	提交任务时返回的任务 ID。

返回示例

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0"
    ],
    "consumed_credits": 10,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

计费

每张图片费用

10 积分 / 张

任务失败不扣费。站内其他模型使用各自的积分费率。

错误处理

401 未授权无效的 API Key
402 需要付款余额不足
429 请求过多触发速率限制

关于 GPT Image 2.0

GPT Image 2.0 是 AI Image 2 使用的图像模型。AI Image 2 是独立服务，与 OpenAI 没有任何关联、背书或赞助关系。

GPT Image 2.0 —— 精准遵循提示词、图内文字清晰可读

GPT Image 2.0 能紧密遵循复杂指令，在图像中渲染清晰可读的文字，并支持传入参考照片，直接编辑现有图片而无需从零开始。

擅长排版、版式与参考图编辑

模型在海报、信息图和 UI 样机等需要文字清晰可读的场景表现稳定；传入参考图时，可在更换风格或背景的同时保持主体一致。

适用场景

图内文字清晰——可在海报与信息图中渲染标题、标签和短标语。
参考图编辑——传入一张或多张图片 URL，在保留主体的前提下重设风格或重组画面。
结构化版式——可处理菜单、传单、分镜故事板等多元素、有序面板的构图。
1K 至 4K 输出——可选 1K、2K 或 4K；1:1 不支持 4K，5:4 与 4:5 仅支持 1K。
11 种宽高比——auto、1:1、5:4、9:16、21:9、16:9、4:3、3:2、4:5、3:4、2:3。
统一计费——每张图 10 积分，仅在任务成功时扣费。

使用方式

promptprompt —— 自然语言描述；写明要在图中渲染的确切文字（最多 20000 字符）。
imagesimages —— 可选的参考图 URL 数组；模型会对其进行编辑或重组。
resolutionresolution —— 1K（默认）、2K 或 4K；各尺寸均消耗相同 10 积分。

GPT Image 2 prompts Examples