image2-4k 分组

创建令牌时请选择 image2-4k 分组。提交后回到令牌列表，在目标令牌的密钥栏直接复制，再将复制的完整 API Key 替换示例中的 YOUR_API_KEY。

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

文本生成图片
参考图编辑

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

接口说明

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

什么场景适合使用

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

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

image2-4k 分组使用 gpt-image-2-4k。本页包含两种调用方式：生图、参考图编辑。

4K 请求处理时间较长，下面的 Python 示例将客户端超时时间设置为 1800 秒。请求时需要同时使用长连接图片域名 https://img-api.apinebula.ai、模型 gpt-image-2-4k、尺寸 3840x2160 和 quality=high。

生图

接口

POST /v1/images/generations

调用方式

cURL
Python
TypeScript

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-4k",
    "prompt": "一只成年橘色虎斑猫完整端坐在简洁的深灰色摄影棚地面上，身体略微朝右，脸看向镜头，全身和尾巴完整入镜。它有浓密自然的橘色短毛、额头清晰的深橘色 M 形虎斑、白色下巴、翠绿色眼睛，佩戴一条细窄的青绿色项圈和一个小巧圆形银色吊牌，尾巴弯曲环绕前爪。柔和主光从左前方照射，右侧有轻微轮廓光，毛发、胡须、眼睛反光和爪部细节清晰，背景干净克制。16:9 横屏，电影级写实宠物摄影，单一完整画面，不要拼贴、分栏、文字、标志或水印。",
    "size": "3840x2160",
    "quality": "high",
    "response_format": "url"
  }'

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-4k",
        "prompt": "一只成年橘色虎斑猫完整端坐在简洁的深灰色摄影棚地面上，身体略微朝右，脸看向镜头，全身和尾巴完整入镜。它有浓密自然的橘色短毛、额头清晰的深橘色 M 形虎斑、白色下巴、翠绿色眼睛，佩戴一条细窄的青绿色项圈和一个小巧圆形银色吊牌，尾巴弯曲环绕前爪。柔和主光从左前方照射，右侧有轻微轮廓光，毛发、胡须、眼睛反光和爪部细节清晰，背景干净克制。16:9 横屏，电影级写实宠物摄影，单一完整画面，不要拼贴、分栏、文字、标志或水印。",
        "size": "3840x2160",
        "quality": "high",
        "response_format": "url",
    },
    timeout=1800,
)
resp.raise_for_status()

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

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-4k",
  prompt: "一只成年橘色虎斑猫完整端坐在简洁的深灰色摄影棚地面上，身体略微朝右，脸看向镜头，全身和尾巴完整入镜。它有浓密自然的橘色短毛、额头清晰的深橘色 M 形虎斑、白色下巴、翠绿色眼睛，佩戴一条细窄的青绿色项圈和一个小巧圆形银色吊牌，尾巴弯曲环绕前爪。柔和主光从左前方照射，右侧有轻微轮廓光，毛发、胡须、眼睛反光和爪部细节清晰，背景干净克制。16:9 横屏，电影级写实宠物摄影，单一完整画面，不要拼贴、分栏、文字、标志或水印。",
  size: "3840x2160",
  quality: "high",
  response_format: "url",
});

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

响应示例

{
  "created": 1784866417,
  "data": [
    {
      "b64_json": "<完整图片 Base64，已省略>",
      "revised_prompt": null,
      "url": "https://cdnimage2.fapinebula.vip/..."
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 551,
    "total_tokens": 563,
    "input_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 12,
      "image_tokens": 0
    },
    "output_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0,
      "reasoning_tokens": 0
    }
  }
}

当 response_format=url 时，优先读取 data[0].url；如果选择 b64_json，读取 data[0].b64_json。服务端可能同时返回另一个字段，具体以实际响应为准。请下载图片后检查真实像素，不要只根据请求参数判断分辨率。

参数支持

参数	类型	支持情况	说明
`model`	`string`	支持	固定填写 `gpt-image-2-4k`。
`prompt`	`string`	支持	图片描述提示词，建议写清楚主体、场景、风格、比例和文字内容。
`n`	`integer`	支持 1–10	一次最多返回 10 张图片。
`size`	`string`	仅支持 `3840x2160`	配合长连接图片域名和 `gpt-image-2-4k` 使用。
`quality`	`string`	支持	接口可接收 `low`、`medium`、`high`、`auto`；如需获得 `3840x2160`，请使用 `high`。
`response_format`	`string`	支持	可选 `url`、`b64_json`；分别优先读取 `data[0].url` 或 `data[0].b64_json`，以实际响应为准。
`output_format`	`string`	支持	支持 `jpeg`。
`output_compression`	`integer`	支持	配合 `output_format=jpeg` 使用，取值 0 到 100。
`background`	`string`	部分支持	支持默认值或 `opaque`；`transparent` 不支持。
`moderation`	`string`	支持	可选 `auto`、`low`；这是安全审核参数，不会直接改变画面风格。
`user`	`string`	支持	可选，用于标记你自己的终端用户或业务来源，普通调用可以不传。

调用示例统一使用 3840x2160 横屏尺寸。

示例效果

GPT Image 2 4K 橘猫生图效果

参考图编辑

接口

POST /v1/images/edits

调用方式

cURL
Python
TypeScript

curl https://img-api.apinebula.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2-4k" \
  -F "prompt=以输入图中的橘猫为唯一主体，严格保留它的面部、体型、橘色虎斑纹路、额头 M 形花纹、白色下巴、翠绿色眼睛、青绿色项圈、圆形银色吊牌和端坐姿态，使人一眼认出是同一只猫。彻底移除深灰摄影棚背景，将猫自然放置在雨后赛博城市高层露台的夜景中：脚下是湿润的深色金属地面和积水倒影，背景有层叠的未来摩天楼、空中轨道、悬浮车辆光轨、青蓝与洋红色霓虹灯、薄雾和细雨。让青蓝色环境光和洋红色轮廓光真实落在猫的毛发与地面上，同时保留暖橙色毛发的自然质感。猫位于前景偏右，背景具有明显纵深。16:9 横屏，电影级写实摄影，无可辨认文字、品牌标志或水印。" \
  -F "size=3840x2160" \
  -F "quality=high" \
  -F "response_format=url" \
  -F "input_fidelity=high" \
  -F "[email protected]"

import requests

resp = requests.post(
    "https://img-api.apinebula.ai/v1/images/edits",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    data={
        "model": "gpt-image-2-4k",
        "prompt": "以输入图中的橘猫为唯一主体，严格保留它的面部、体型、橘色虎斑纹路、额头 M 形花纹、白色下巴、翠绿色眼睛、青绿色项圈、圆形银色吊牌和端坐姿态，使人一眼认出是同一只猫。彻底移除深灰摄影棚背景，将猫自然放置在雨后赛博城市高层露台的夜景中：脚下是湿润的深色金属地面和积水倒影，背景有层叠的未来摩天楼、空中轨道、悬浮车辆光轨、青蓝与洋红色霓虹灯、薄雾和细雨。让青蓝色环境光和洋红色轮廓光真实落在猫的毛发与地面上，同时保留暖橙色毛发的自然质感。猫位于前景偏右，背景具有明显纵深。16:9 横屏，电影级写实摄影，无可辨认文字、品牌标志或水印。",
        "size": "3840x2160",
        "quality": "high",
        "response_format": "url",
        "input_fidelity": "high",
    },
    files={
        "image": ("orange-tabby-cat-4k.png", open("orange-tabby-cat-4k.png", "rb"), "image/png"),
    },
    timeout=1800,
)
resp.raise_for_status()

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

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-4k",
  image: fs.createReadStream("orange-tabby-cat-4k.png"),
  prompt: "以输入图中的橘猫为唯一主体，严格保留它的面部、体型、橘色虎斑纹路、额头 M 形花纹、白色下巴、翠绿色眼睛、青绿色项圈、圆形银色吊牌和端坐姿态，使人一眼认出是同一只猫。彻底移除深灰摄影棚背景，将猫自然放置在雨后赛博城市高层露台的夜景中：脚下是湿润的深色金属地面和积水倒影，背景有层叠的未来摩天楼、空中轨道、悬浮车辆光轨、青蓝与洋红色霓虹灯、薄雾和细雨。让青蓝色环境光和洋红色轮廓光真实落在猫的毛发与地面上，同时保留暖橙色毛发的自然质感。猫位于前景偏右，背景具有明显纵深。16:9 横屏，电影级写实摄影，无可辨认文字、品牌标志或水印。",
  size: "3840x2160",
  quality: "high",
  response_format: "url",
  input_fidelity: "high",
});

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

响应示例

{
  "created": 1784866520,
  "data": [
    {
      "b64_json": null,
      "revised_prompt": "<模型重写后的提示词>",
      "url": "https://cdnimage2.fapinebula.vip/..."
    }
  ],
  "usage": {
    "input_tokens": 1514,
    "output_tokens": 551,
    "total_tokens": 2065,
    "input_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 6,
      "image_tokens": 1508
    },
    "output_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0,
      "reasoning_tokens": 0
    }
  }
}

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

参数支持

参数	类型	支持情况	说明
`model`	`string`	支持	固定填写 `gpt-image-2-4k`。
`prompt`	`string`	支持	图片编辑提示词，建议写清楚要保留什么、替换什么、输出风格和主体关系。
`image`	`file[]`	支持	可上传一张或多张参考图；多张图片使用重复的 `image` 字段。
`n`	`integer`	支持 1–10	一次最多返回 10 张图片。
`size`	`string`	仅支持 `3840x2160`	图片尺寸固定为 `3840x2160`。
`quality`	`string`	支持	接口可接收 `low`、`medium`、`high`、`auto`；如需获得 `3840x2160`，请使用 `high`。
`response_format`	`string`	支持	可选 `url`、`b64_json`。
`input_fidelity`	`string`	支持	支持 `high`，用于提高对输入参考图的跟随程度。
`output_format`	`string`	支持	支持 `jpeg`。
`output_compression`	`integer`	支持	配合 `output_format=jpeg` 使用，取值 0 到 100。
`background`	`string`	部分支持	支持默认值或 `opaque`；`transparent` 不支持。
`moderation`	`string`	支持	可选 `auto`、`low`；这是安全审核参数。
`user`	`string`	支持	可选，用于标记你自己的终端用户或业务来源。

示例文件

文件	用途
`orange-tabby-cat-4k.png`	生图示例输出，同时作为参考图编辑的输入，用于保留同一只橘猫的外观特征。

示例效果

参考图	改图结果

接口说明​

什么场景适合使用​

生图​

接口​

调用方式​

响应示例​

参数支持​

示例效果​

参考图编辑​

接口​

调用方式​

响应示例​

参数支持​

示例文件​

示例效果​

继续阅读​

接口说明

什么场景适合使用

生图

接口

调用方式

响应示例

参数支持

示例效果

参考图编辑

接口

调用方式

响应示例

参数支持

示例文件

示例效果

继续阅读