gpt-image-2-1k 分组

GPT Image 2.5 是一组用于图片生成与图片编辑的能力，适合下面这些场景：

• 文本生成图片
• 参考图编辑

在 APINebula 中，你可以通过 OpenAI 兼容接口直接接入。

视频教程：终端调用 gpt-image-2.5

如果你更习惯跟着视频操作，可以先观看下面的终端生图教程，再按本页文字步骤完成配置。

创建令牌时，请选择模型广场中对应的图片分组。提交后回到令牌列表，在目标令牌的密钥栏直接复制，再将复制的完整 API Key 替换示例中的 YOUR_API_KEY。

接口说明

• 生图接口：POST https://img-api.apinebula.ai/v1/images/generations
• 改图接口：POST https://img-api.apinebula.ai/v1/images/edits
• 模型名称：gpt-image-2.5

什么场景适合使用

如果你只是想通过一次请求直接生成图片，或者基于已有图片做编辑，那么优先使用 Images API 就可以。

如果你的业务还需要把图片能力和更长的对话、多轮工作流、工具调用组合在一起，再考虑配合其他对话接口一起设计。

gpt-image-2-1k 分组使用 gpt-image-2.5。本页包含生图和参考图编辑两种调用方式。

生图

接口

POST /v1/images/generations

调用方式

cURL

curl https://img-api.apinebula.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "一张简洁的商业产品图，浅灰背景中摆放一只银白色无线耳机充电盒，光线柔和，细节清晰。",
    "size": "1024x1024",
    "quality": "medium",
    "response_format": "url"
  }'

Python

import requests

resp = requests.post(
    "https://img-api.apinebula.ai/v1/images/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2.5",
        "prompt": "一张简洁的商业产品图，浅灰背景中摆放一只银白色无线耳机充电盒，光线柔和，细节清晰。",
        "size": "1024x1024",
        "quality": "medium",
        "response_format": "url",
    },
    timeout=120,
)
resp.raise_for_status()

print(resp.json()["data"][0]["url"])

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://img-api.apinebula.ai/v1",
});

const result = await client.images.generate({
  model: "gpt-image-2.5",
  prompt: "一张简洁的商业产品图，浅灰背景中摆放一只银白色无线耳机充电盒，光线柔和，细节清晰。",
  size: "1024x1024",
  quality: "medium",
  response_format: "url",
});

console.log(result.data[0].url);

响应示例

{
  "created": 1784867600,
  "data": [
    {
      "url": "https://cdnimage2.fapinebula.vip/..."
    }
  ],
  "quality": "medium",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 30,
    "output_tokens": 765,
    "total_tokens": 795,
    "input_tokens_details": {
      "text_tokens": 30,
      "image_tokens": 0
    },
    "output_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 765
    }
  }
}

图片 URL 位于 data[0].url。URL 每次请求都会变化，请直接读取返回字段，不要拼接示例地址。

参数支持

参数	类型	支持情况	说明
model	string	支持	固定填写 gpt-image-2.5。
prompt	string	支持	图片描述提示词，建议写清楚主体、场景、风格、比例和文字内容。
n	integer	仅支持 1	一次返回 1 张图片。
size	string	不完全支持	本页示例使用 1024x1024；可用尺寸以当前模型广场和接口返回为准。需要更高分辨率时，请先确认对应分组是否已开放。
quality	string	不完全支持	可选 low、medium、high、auto。
response_format	string	支持	可选 url、b64_json；url 返回 data[0].url，b64_json 返回 data[0].b64_json。
output_format	string	部分支持	可传 png、jpeg，不能作为稳定格式开关。
output_compression	integer	部分支持	可与 output_format 一起传入，取值 0 到 100；仅当输出格式实际生效为 jpeg 时才有压缩意义。
background	string	支持	支持 opaque、transparent。
moderation	string	支持	可选 auto、low；这是安全审核参数，不会直接改变画面风格。
user	string	支持	可选，用于标记你自己的终端用户或业务来源，普通调用可以不传。

示例效果

参考图编辑

接口

POST /v1/images/edits

调用方式

cURL

curl https://img-api.apinebula.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2.5" \
  -F "prompt=将第一张图中的无线耳机充电盒摆放到第二张图的木质办公桌场景中，保留真实阴影、金属高光和桌面透视关系。" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "response_format=url" \
  -F "input_fidelity=high" \
  -F "[email protected]" \
  -F "[email protected]"

Python

import requests

resp = requests.post(
    "https://img-api.apinebula.ai/v1/images/edits",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    data={
        "model": "gpt-image-2.5",
        "prompt": "将第一张图中的无线耳机充电盒摆放到第二张图的木质办公桌场景中，保留真实阴影、金属高光和桌面透视关系。",
        "size": "1536x1024",
        "quality": "high",
        "response_format": "url",
        "input_fidelity": "high",
    },
    files=[
        ("image", ("product.png", open("product.png", "rb"), "image/png")),
        ("image", ("background.png", open("background.png", "rb"), "image/png")),
    ],
    timeout=120,
)
resp.raise_for_status()

print(resp.json()["data"][0]["url"])

TypeScript

import OpenAI from "openai";
import fs from "fs";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://img-api.apinebula.ai/v1",
});

const result = await client.images.edit({
  model: "gpt-image-2.5",
  image: [
    fs.createReadStream("product.png"),
    fs.createReadStream("background.png"),
  ],
  prompt: "将第一张图中的无线耳机充电盒摆放到第二张图的木质办公桌场景中，保留真实阴影、金属高光和桌面透视关系。",
  size: "1536x1024",
  quality: "high",
  response_format: "url",
  input_fidelity: "high",
});

console.log(result.data[0].url);

响应示例

{
  "created": 1784867700,
  "data": [
    {
      "url": "https://cdnimage2.fapinebula.vip/..."
    }
  ],
  "quality": "high",
  "size": "1536x1024",
  "usage": {
    "input_tokens": 1564,
    "output_tokens": 1105,
    "total_tokens": 2669,
    "input_tokens_details": {
      "text_tokens": 34,
      "image_tokens": 1530
    },
    "output_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 1105
    }
  }
}

图片 URL 位于 data[0].url。data 是数组；多参考图是一次编辑请求的多个输入，不代表响应会按输入图片数量逐张返回。

参数支持

参数	类型	支持情况	说明
model	string	支持	固定填写 gpt-image-2.5。
prompt	string	支持	图片编辑提示词，建议写清楚要保留什么、替换什么、输出风格和主体关系。
image	file[]	支持	可上传一张或多张参考图；多张图片使用重复的 image 字段。
n	integer	仅支持 1	只支持一次返回 1 张图；多图数量不支持。
size	string	不完全支持	本页示例使用 1536x1024；可用尺寸以当前模型广场和接口返回为准。
quality	string	不完全支持	可选 low、medium、high、auto。
response_format	string	支持	可选 url、b64_json。
input_fidelity	string	支持	支持 high，用于提高对输入参考图的跟随程度。
output_format	string	部分支持	可传 png、jpeg，不能作为稳定格式开关。
output_compression	integer	部分支持	可与 output_format 一起传入，取值 0 到 100；仅当输出格式实际生效为 jpeg 时才有压缩意义。
background	string	支持	支持 opaque、transparent；transparent 可返回带 alpha 通道的 PNG。
moderation	string	支持	可选 auto、low；这是安全审核参数。
user	string	支持	可选，用于标记你自己的终端用户或业务来源。

示例效果

产品输入图	背景输入图	编辑输出图

继续阅读

• 图片总览
• image2-4k 分组
• nanobanana 分组
• 图片异步任务接口