1. 图片生成（Images）
AI接口文档
  • 图片生成（Images）
    • 香蕉（异步）
      POST
    • image2（同步）
      POST
    • gpt-image-2（异步）
      POST
    • 任务查询
      GET
  • 视频生成（Videos）
    • sora创建
      POST
    • Omni创建
      POST
    • veo创建
      POST
    • 任务查询
      GET
  • 失效接口
    • sora视频接口
      POST
    • nano banana接口Gemini 原生格式
      POST
    • veo（直出15s）
      POST
    • Veo （延长至15s）
      POST
  1. 图片生成（Images）

image2（同步）

开发中
POST
/v1/images/generations

gpt-image-2 接口文档（OpenAI 原生格式）#

接口地址#

用途方法路径响应格式
文生图（图片 API）POST/v1/images/generations{ created, data: [{ url }] }
图生图（图片编辑）POST/v1/images/edits同上
文生图 / 图生图（Chat API）POST/v1/chat/completionschat.completion，图片在 choices[0].message.content 的 markdown 里

功能说明#

采用 OpenAI 原生端点格式的图片生成接口，支持文生图和图生图两种模式。
/v1/images/generations、/v1/images/edits：标准图片 API，返回 { data: [{ url }] }。
/v1/chat/completions：兼容 Chat Completions 调用方式；网关将 messages 自动转为内部 prompt + 参考图，响应为 Chat 格式（![image](url)）。

支持的模型#

model 参数分辨率说明
gpt-image21K / 2K / 4K全档位；需要 2K、4K 或更大像素尺寸时使用
image2仅 1K更便宜；只需 1K 档图片时优先使用
选型建议
要用 1K、2K、4K 或较大自定义像素（如 3696x1584）→ 用 gpt-image2
只要 1K，追求更低成本 → 用 image2

请求头#

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是图片 API：支持 application/json 与 multipart/form-data；Chat API：仅 application/json

一、文生图接口#

接口地址#

POST /v1/images/generations

请求参数#

参数名类型必填说明
modelstring是gpt-image2 或 image2（见上表）
promptstring是图片描述，用于生成图片
sizestring否图片尺寸，如 1024x1792、3696x1584

请求示例（JSON — 纯文生图，1K 省钱）#

请求示例（JSON — 纯文生图，支持 2K/4K）#

请求示例（表单格式）#

二、图生图（图片编辑）接口#

接口地址#

POST /v1/images/edits

请求参数#

参数名类型必填说明
modelstring是gpt-image2 或 image2
promptstring是图片描述，用于编辑图片
image见说明是JSON：string（单图）或 string[]（多图）；Multipart：文件字段（常见名 image）
sizestring否图片尺寸，格式同文生图

请求示例（JSON — URL）#

请求示例（JSON — Data URL / Base64）#

{
  "model": "gpt-image2",
  "prompt": "变成灰色",
  "size": "1024x1792",
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}
多图时 "image": ["data:image/png;base64,...", "https://..."]，单图可传字符串或单元素数组。

请求示例（表单格式 — 本地文件）#

Python 示例（JSON，直接传 URL）#

三、Chat Completions 接口（文生图 / 图生图）#

接口地址#

POST /v1/chat/completions

功能说明#

入参使用 OpenAI Chat 的 messages 格式（text + 可选 image_url）。
网关自动转为内部 prompt + 参考图，与图片 API 共用同一套生成逻辑。
响应为 chat.completion，成品图 URL 在：
choices[0].message.content
形如：![image](https://成品图地址)\n\n

请求参数#

参数名类型必填说明
modelstring是gpt-image2 或 image2
messagesarray是至少一条 role: user 的消息
sizestring否图片尺寸，如 3696x1584、1024x1792
messages[].content 支持两种写法：
1.
字符串：纯文生图
"content": "做一个广告"
2.
数组：文生图或图生图
{ "type": "text", "text": "..." }
{ "type": "image_url", "image_url": { "url": "https://..." } }（图生图）
图生图请使用 image_url，不要用顶层 image 字段（那是图片 API 的字段名）。

请求示例 — Chat 文生图（纯文本）#

写法 A：content 为字符串
写法 B：content 为数组（仅 text）
{
  "model": "image2",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "做一个广告" }
      ]
    }
  ],
  "size": "1024x1792"
}

请求示例 — Chat 图生图（text + 参考图）#

Chat 响应示例#

{
  "id": "chatcmpl-d202e7d4-370f-4dd4-817c-6f7d212cc2e3",
  "object": "chat.completion",
  "created": 1784359143,
  "model": "gpt-image2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![image](https://oss-us.file-download.life/2026/07/18/7acea2ac13eca4beae93f427862e6f9e.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ]
}
成品图 URL 在 choices[0].message.content 里，格式固定为 markdown：![image](https://...)\n\n。可用正则提取：

Python 示例（Chat 图生图）#

四、响应示例（图片 API）#

{
  "data": [
    {
      "url": "https://res.papir.cc/output/2026-04-18/xxxxxx.png"
    }
  ],
  "created": 1782108238
}

任务状态说明（异步上游时）#

status说明
queued任务排队中
in_progress任务处理中
completed任务已完成
failed任务失败

注意事项#

1.
接口格式：采用 OpenAI 原生端点，与常见 OpenAI SDK / 兼容客户端通用。
2.
三种端点怎么选：
纯文生图、要标准 { data: [{ url }] } → /v1/images/generations
带参考图的图生图 → /v1/images/edits
客户端已是 Chat / messages 形态 → /v1/chat/completions
3.
响应格式：
图片 API：返回 { data: [{ url }] }
Chat API：从 message.content 取 ![image](url)
4.
模型与分辨率：
gpt-image2：1K / 2K / 4K，适合高分辨率或高档位
image2：仅 1K，价格更低
5.
尺寸示例：
竖屏：1024x1792
横屏：1792x1024、3024x1296
方形：1024x1024
其他像素可在 size 中自定义（如 3696x1584）
6.
参考图（图生图）：
/v1/images/edits：JSON 下用字段 image（URL / Base64 / 数组）；multipart 上传文件
/v1/chat/completions：在 messages[].content 里用 image_url
参考图 URL 须公网可访问（上游服务器需能下载）；防盗链地址可能报 Failed to fetch image_url
7.
参考图格式：支持 JPEG、PNG、WEBP 等常见图片格式
8.
图片有效期：返回 URL 通常有时效（如约 2 小时），请及时保存

请求参数

Header 参数

Body 参数application/json必填

示例
{
  "model": "image2",
  "prompt": "根据图片做一个广告",
  "size": "1024x1792",
  "image": [
    "https://xxxxxxxx.jpg",
    "https://xxxxxxxx.png"
  ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "model": "image2",
  "prompt": "根据图片做一个广告",
  "size": "1024x1792",
  "image": [
    "https://xxxxxxxx.jpg",
    "https://xxxxxxxx.png"
  ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSU..."
        }
    ],
    "created": 1782108238,
    "usage": {
        "input_tokens": 4,
        "output_tokens": 1105,
        "total_tokens": 1109,
        "input_tokens_details": {
            "text_tokens": 4,
            "image_tokens": 0
        },
        "output_tokens_details": {
            "text_tokens": 0,
            "image_tokens": 1105
        }
    }
}
修改于 2026-07-18 07:36:19
上一页
香蕉（异步）
下一页
gpt-image-2（异步）
Built with