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）

香蕉（异步）

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

图片生成接口文档#

接口地址#

POST /v1/videos

功能说明#

支持文生图和图生图两种模式的图片生成（与视频生成共用接口，通过model参数区分）

支持的模型#

model 参数说明
nano_banana_2标准版，速度快
nano_banana_pro-1KPro 版，1K 分辨率
nano_banana_pro-2KPro 版，2K 分辨率
nano_banana_pro-4KPro 版，4K 分辨率

请求头#

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

请求参数#

参数名类型必填说明
modelstring是模型名称，如：nano_banana_2、nano_banana_pro、nano_banana_pro-1K 等
promptstring是文本提示词，最大长度10000字符
metadataobject否元数据对象，包含图片生成的额外参数
metadata.aspect_ratiostring否宽高比
图像比例支持的参数:auto（默认），1:1，16:9，9:16，4:3，3:4，3:2，2:3，5:4，4:5，21:9；香蕉2额外支持：1:4，4:1，1:8，8:1尺寸；
metadata.urlsstring[]否参考图片数组（支持Base64或URL），最多5张。传此参数为图生图模式，不传为文生图模式
metadata.imageSizestring否图片尺寸，如：1K、2K 等

请求示例#

文生图模式#

请求体（JSON）：
{
  "model": "nano_banana_2",
  "prompt": "美丽的日出风景，金色的阳光洒在宁静的湖面上，远处是连绵的山脉",
  "metadata": {
    "aspect_ratio": "16:9",
    "urls": []
  }
}

图生图模式（Base64格式）#

图生图模式（URL格式）#

响应参数#

参数名类型说明
idstring任务ID，格式：task_nano_xxx 或 task_xxx
objectstring对象类型，固定值：image
modelstring使用的模型名称
statusstring任务状态：queued（排队中）、processing（处理中）、completed（已完成）、failed（失败）
progressnumber任务进度，0-100
creatednumber创建时间戳（秒）
urlstring生成的图片URL（仅在completed状态返回）

响应示例#

提交成功（排队中）#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "image",
  "model": "nano_banana_2",
  "status": "queued",
  "progress": 0,
  "created": 1709876543
}

任务完成#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "image",
  "model": "nano_banana_2",
  "status": "completed",
  "progress": 100,
  "created": 1709876543,
  "url": "https://example.com/images/xxx.jpg"
}

注意事项#

1.
接口复用：图片生成使用 /v1/videos 接口，与视频生成共用，因为图片的newapi接口没有轮询，通过 model 参数区分（nano_banana 开头为图片生成）
2.
参数传递：图片生成的特定参数（aspect_ratio、urls等）需要放在 metadata 对象中
3.
参考图片格式：支持JPEG、PNG、WEBP格式，单张图片最大10MB
4.
参考图片数量：最多上传5张参考图片
5.
参考图片来源：支持两种格式
Base64格式：需包含完整的Data URL前缀（如：data:image/jpeg;base64,）
URL格式：直接传入可访问的图片URL地址
6.
任务模式：
metadata.urls 为空数组或不传 = 文生图模式
metadata.urls 包含图片（Base64或URL） = 图生图模式
7.
异步处理：接口返回任务ID后，需要通过轮询机制查询任务进度和结果

请求参数

Header 参数

Body 参数application/json必填

示例
{
  "model": "nano_banana_2",
  "prompt": "美丽的日出风景，金色的阳光洒在宁静的湖面上，远处是连绵的山脉",
  "metadata": {
    "aspect_ratio": "16:9",
    "urls": [
      "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 'https://otuapi.com/v1/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "model": "nano_banana_2",
  "prompt": "美丽的日出风景，金色的阳光洒在宁静的湖面上，远处是连绵的山脉",
  "metadata": {
    "aspect_ratio": "16:9",
    "urls": [
      "https://xxxxxxxx.jpg",
      "https://xxxxxxxx.png"
    ]
  }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "id": "task_xxxxxxxxxxxxx",
  "object": "image",
  "model": "nano_banana_2",
  "status": "completed",
  "progress": 100,
  "created": 1709876543,
  "url": "https://example.com/images/xxx.jpg"
}
修改于 2026-05-27 01:23:04
上一页
香蕉（gemini原生格式）
下一页
image2（流式）
Built with