三步快速对接 gpt-image-2 图像生成 API 教程

前言

gpt-image-2 是当下高性能 AI 图像生成模型，支持自定义尺寸、风格定制、批量生成等能力，接口规范完全标准化、兼容主流开发生态。

本文基于官方 Apifox 接口文档，以 https://api.aaigc.top 为统一请求域名，整理极简三步对接方案，全代码可直接复制运行，快速完成项目集成。

一、接口基础信息

项目	说明
模型名称	gpt-image-2
接口能力	文本生成图像、自定义风格绘画
请求方式	POST
提交接口	https://api.aaigc.top/v1/images/generate
查询接口	https://api.aaigc.top/v1/images/query
数据格式	application/json
接口类型	异步任务模式

二、三步极速对接

第一步：获取授权密钥

访问官方平台：https://api.aaigc.top
注册并登录账号，进入密钥管理中心
复制个人专属 API Key，格式通常为 sk- 开头
妥善保管密钥，禁止前端明文暴露

第二步：统一请求头配置

所有接口请求必须携带鉴权头部，缺一不可：

http 复制代码

Authorization: Bearer 你的API_KEY
Content-Type: application/json
Accept: application/json

第三步：提交生成任务

通过图像创建接口，传入模型参数、绘画提示词，即可提交生成任务。

三、请求参数详解

参数	类型	是否必填	说明
model	string	是	固定填写：`gpt-image-2`
prompt	string	是	图像生成提示词，支持中文/英文、风格描述
size	string	是	图像尺寸，支持主流比例规格
num	int	否	单次生成图片数量，默认 1 张
style	string	否	风格参数：写实、二次元、国风、赛博朋克等

四、完整可运行代码示例

1. cURL 请求示例

bash 复制代码

curl --location -X POST 'https://api.aaigc.top/v1/images/generate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 你的API_KEY' \
--data '{
    "model": "gpt-image-2",
    "prompt": "二次元动漫少女，唯美画风，高清8K",
    "size": "1024x1024",
    "num": 1
}'

2. Python 调用示例

python 复制代码

import requests
import json

url = "https://api.aaigc.top/v1/images/generate"
headers = {
    "Authorization": "Bearer 你的API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "model": "gpt-image-2",
    "prompt": "赛博朋克城市夜景，科幻风格，细节拉满",
    "size": "1024x1024",
    "num": 1
}

res = requests.post(url, headers=headers, data=json.dumps(payload))
print(res.json())

3. Axios / JavaScript 示例

javascript 复制代码

const axios = require("axios");

const url = "https://api.aaigc.top/v1/images/generate";
const headers = {
  "Authorization": "Bearer 你的API_KEY",
  "Content-Type": "application/json"
};

const data = {
  model: "gpt-image-2",
  prompt: "治愈系风景插画，简约清新",
  size: "1024x1024"
};

axios.post(url, data, { headers })
  .then(res => console.log(res.data))
  .catch(err => console.error("请求失败：", err));

五、接口响应说明

任务提交成功返回

json 复制代码

{
    "task_id": "img2_20260424_xxxxxx",
    "status": "pending",
    "create_time": 1762241017
}

字段	释义
task_id	任务唯一标识，用于查询图片结果
status	pending 生成中 / completed 已完成 / failed 生成失败
create_time	任务创建时间戳

六、结果查询方式

使用拿到的 task_id，调用查询接口轮询获取成品图片地址：

查询接口地址：https://api.aaigc.top/v1/images/query
传入参数：{"task_id":"xxx"}

七、开发注意事项

gpt-image-2 为异步生成，提交后需轮询查询接口获取结果；
尺寸参数严格遵循规范格式，非法参数会直接返回报错；
建议后端统一代理调用，防止 API Key 泄露造成额度损耗；
支持超长提示词、细节化描述，大幅提升出图质量；
平台高并发稳定运行，支持批量批量任务并发请求。

八、平台优势

聚合全品类大模型：GPT、Claude、Gemini、Sora2、gpt-image-2、grok-video-3
低费率计费、失败不计费，开发成本更低
文档完善、接口统一，无缝适配各类 AI 工具
新用户注册赠送免费测试额度，快速上手调试

一站式 AI 聚合中转平台

官方地址：https://api.aaigc.top