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

大型API聚合网
0 阅读3分钟

前言

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

一、接口基础信息

表格

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

二、三步极速对接

第一步：获取授权密钥

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

第二步：统一请求头配置

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

http

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

第三步：提交生成任务

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

三、请求参数详解

表格

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

四、完整可运行代码示例

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任务唯一标识，用于查询图片结果
statuspending 生成中 /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. 平台高并发稳定运行，支持批量批量任务并发请求。
avatar
文章
阅读
粉丝