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

前言

gpt-image-2 是当下高性能 AI 图像生成模型，支持自定义尺寸、风格定制、批量生成等能力，接口规范完全标准化、兼容主流开发生态。
本文基于官方 Apifox 接口文档，以https://api.aaigc.top为统一请求域名，整理极简三步对接方案，全代码可直接复制运行，快速完成项目集成。

一、接口基础信息

二、三步极速对接

第一步：获取授权密钥

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

第二步：统一请求头配置

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

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

第三步：提交生成任务

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

三、请求参数详解

四、完整可运行代码示例

1. cURL 请求示例

curl--location-XPOST'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 调用示例

importrequestsimportjson 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 示例

constaxios=require("axios");consturl="https://api.aaigc.top/v1/images/generate";constheaders={"Authorization":"Bearer 你的API_KEY","Content-Type":"application/json"};constdata={model:"gpt-image-2",prompt:"治愈系风景插画，简约清新",size:"1024x1024"};axios.post(url,data,{headers}).then(res=>console.log(res.data)).catch(err=>console.error("请求失败：",err));

五、接口响应说明

任务提交成功返回

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

六、结果查询方式

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

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

七、开发注意事项

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

八、平台优势

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

一站式 AI 聚合中转平台
官方地址：https://api.aaigc.top