三步快速对接 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
接口类型 异步任务模式

二、三步极速对接

第一步:获取授权密钥

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

第二步:统一请求头配置

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

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"}

七、开发注意事项

  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


相关推荐
谙弆悕博士1 天前
从“预测下一个词”到“预测世界下一状态”:世界模型是不是下一个AGI叙事?
人工智能·gpt·深度学习·神经网络·agi·jepa·genie 4
泓博2 天前
Android仿写苹果缩放窗口
人工智能·gpt·深度学习
Eloudy3 天前
从 DeepSeek-V1 到 DeepSeek-V2:一次从“堆稠密参数”到“稀疏计算+压缩缓存”的架构转向
gpt·llm·transformer
小小-猿3 天前
从 gpt-6-luna 到第一个 Nexent 智能体:配置、调试与发布
gpt·大模型·智能体·ai智能体·nexent
良逍Ai出海4 天前
用上 Gemini 4 Carbon:比 GPT-6 Astra 还强
gpt
可乐ea4 天前
智能体的模型列表为什么要从三处来源合成:一次让 GPT-6.1 Sol 选不上的发布延迟
人工智能·gpt·chatgpt·智能体框架·模型列表·多源数据合成·客户端工程
AllData公司负责人4 天前
AI大模型数据开发底座系列说明书:AllData集成DB-GPT开源项目建设 AI 多模态分析底座,涵盖模态解析/智能大屏/MCP 扩展!
大数据·数据库·人工智能·gpt·数据采集·数据接入·模态解析
汤姆宝库5 天前
从零手写一个GPT:预训练循环的完整实现
gpt
夕阳_醉了6 天前
Codex 客户端从装好到跑通:第三方 API 接入与配置避坑指南
人工智能·gpt·openai·codex·ai 编程
变量棱镜8 天前
GPT-6.2 灰度的 3D 演示火了
gpt