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

gpt-image-2（异步）

开发中
POST
https://otuapi.com/v1/videos

gpt-image-2 接口文档（/v1/videos 视频接口格式）#

接口地址#

POST /v1/videos

功能说明#

通过 /v1/videos 接口调用 GPT 图片生成能力（与视频生成共用接口，通过 model 参数区分），支持文生图和图生图两种模式，采用异步任务方式，先提交返回任务 ID，再轮询获取结果。
画幅 / 宽高比：通过 metadata.aspect_ratio 参数传入比例字符串（如 9:16、16:9），支持 10 种比例。

支持的模型#

model 参数说明
gpt-image-2GPT 图片生成（标准档）。
gpt-image-2-2K2K 分辨率。
gpt-image-2-4K4K 分辨率。
三者均走同一套 /v1/videos 异步流程与 metadata 约定，仅 model 不同；下游计费与上游路由以 model 区分档位。

请求头#

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是application/json

请求参数#

参数名类型必填说明
modelstring是模型名称，取值为 gpt-image-2、gpt-image-2-2K、gpt-image-2-4K 之一（大小写须与上表一致，其中 2K/4K 为大写 K）
promptstring是文本提示词
metadataobject否元数据对象，包含图片生成的额外参数
metadata.aspect_ratiostring否宽高比，直接传比例字符串。支持：1:1、5:4、9:16、21:9、16:9、3:2、4:3、4:5、3:4、2:3，共 10 种。不传默认 1:1
metadata.urlsstring[]否参考图片数组（支持 Base64 或 URL），最多 5 张。传此参数为图生图模式，不传或为空为文生图模式

请求示例#

文生图模式（竖屏 9:16）#

请求体（JSON）：
{
  "model": "gpt-image-2",
  "prompt": "生成抖音带货风格主图，主体 xxx",
  "metadata": {
    "aspect_ratio": "9:16",
    "urls": []
  }
}

文生图模式（横屏 16:9）#

文生图模式（2K / 4K 档位）#

将 model 改为 gpt-image-2-2K 或 gpt-image-2-4K 即可，metadata.aspect_ratio 用法与标准档相同。

图生图模式（Base64 格式）#

图生图模式（URL 格式）#

响应参数#

参数名类型说明
idstring任务 ID，格式：task_xxxx
objectstring对象类型，固定值：image
modelstring使用的模型名称
statusstring任务状态：queued（排队中）、in_progress（处理中）、completed（已完成）、failed（失败）
progressnumber任务进度，0-100
created_atnumber创建时间戳（秒）
completed_atnumber完成时间戳（秒），仅在 completed 状态返回
video_urlstring生成的图片 URL（与视频接口字段保持一致，实际为图片地址），仅在 completed 状态返回
errorobject错误信息，仅在 failed 状态返回

响应示例#

提交成功（排队中）#

{
  "id": "task_1776831820897",
  "object": "image",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1709876543
}

任务处理中#

{
  "id": "task_1776831820897",
  "object": "image",
  "model": "gpt-image-2",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1709876543
}

任务完成#

{
  "id": "task_1776831820897",
  "object": "image",
  "model": "gpt-image-2",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876598,
  "video_url": "https://example.com/uploads/gpt-images/task_1776831820897.png"
}

任务失败#

{
  "id": "task_1776831820897",
  "object": "image",
  "model": "gpt-image-2",
  "status": "failed",
  "progress": 0,
  "created_at": 1709876543,
  "error": {
    "message": "内容不符合安全规范，请修改提示词或更换参考图片后重试",
    "code": "upstream_error"
  }
}

任务查询接口#

接口地址#

GET /v1/videos/{task_id}

请求示例#

响应说明#

返回字段与提交接口一致，根据 status 字段判断任务是否完成：
queued / in_progress：任务未完成，继续轮询
completed：任务完成，从 video_url 字段获取图片地址
failed：任务失败，从 error.message 获取错误原因

注意事项#

1.
接口复用：GPT 图片生成使用 /v1/videos 接口，与视频生成共用，通过 model 参数区分；GPT 图系列为 gpt-image-2、gpt-image-2-2K、gpt-image-2-4K
2.
参数传递：图片生成的特定参数（aspect_ratio、urls 等）需要放在 metadata 对象中
3.
宽高比：通过 metadata.aspect_ratio 传入比例字符串，支持以下 10 种值：
值方向
1:1正方形
5:4横向
9:16竖向（短视频/手机）
21:9超宽横向
16:9横向（宽屏）
3:2横向
4:3横向
4:5竖向
3:4竖向
2:3竖向
不传 aspect_ratio 时默认为 1:1。
4.
参考图片格式：支持 JPEG、PNG、WEBP 格式
5.
参考图片来源：支持两种格式
Base64 格式：需包含完整的 Data URL 前缀（如：data:image/jpeg;base64,）
URL 格式：直接传入可访问的图片 URL 地址
6.
任务模式：
metadata.urls 为空数组或不传 = 文生图模式
metadata.urls 包含图片（Base64 或 URL） = 图生图模式
7.
异步处理：接口返回任务 ID 后，需要通过轮询 GET /v1/videos/{task_id} 查询任务进度和结果，建议轮询间隔 2~5 秒
8.
图片有效期：生成的图片地址有效期为 5 小时，请及时下载保存
9.
响应字段说明：由于复用视频接口字段，图片地址返回在 video_url 字段中，实际内容为图片

请求参数

Header 参数

Body 参数application/json必填

示例
{
  "model": "gpt-image-2",
  "prompt": "根据图片做一个广告",
  "metadata": {
    "aspect_ratio": "16:9",
    "urls": [
      "https://xxx.cc/xxx.jpg",
      "https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"
    ]
  }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://otuapi.com/v1/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "model": "gpt-image-2",
  "prompt": "根据图片做一个广告",
  "metadata": {
    "aspect_ratio": "16:9",
    "urls": [
      "https://xxx.cc/xxx.jpg",
      "https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"
    ]
  }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-05-15 11:19:05
上一页
image2（流式）
下一页
任务查询
Built with