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）

香蕉（异步）

开发中
POST
/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-1K 等
promptstring是文本提示词，最大长度 10000 字符
aspect_ratiostring否宽高比，可选值：1:1、9:16、16:9、auto，默认 auto
imagesstring[]否参考图片数组（支持 Base64 或 URL），最多 8 张。传此参数为图生图模式，不传或传空数组为文生图模式

images 数组元素传法#

方式示例
图片 URL"https://example.com/reference.jpg"
Base64"data:image/jpeg;base64,/9j/4AAQSkZJRg..."
注意：传入图片 URL 时，网关会自动将其下载并转为 Base64 后发给上游，请确保 URL 为可公网访问的图片直链。

请求示例#

文生图模式#

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

图生图模式（URL 格式）#

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

图生图模式（Base64 格式）#

响应参数#

参数名类型说明
idstring任务 ID，格式：task_nano_xxx 或 task_xxx
objectstring对象类型，固定值：image
modelstring使用的模型名称
statusstring任务状态：queued（排队中）、processing（处理中）、completed（已完成）、failed（失败）
progressnumber任务进度，0–100
creatednumber创建时间戳（秒），提交成功时返回
created_atnumber创建时间戳（秒），任务失败时返回
completed_atnumber完成时间戳（秒），仅在 failed 或 completed 状态返回
urlstring生成的图片 URL（仅在 completed 状态返回）
errorobject错误信息（仅在 failed 状态返回）
error.messagestring失败原因描述
error.codestring错误码，如 upstream_error

响应示例#

提交成功（排队中）#

{
  "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"
}

任务失败#

{
  "id": "task_xxxx",
  "object": "image",
  "model": "nano_banana_2",
  "status": "failed",
  "created_at": 1718123456,
  "completed_at": 1718123456,
  "progress": 100,
  "error": {
    "message": "上游任务失败原因",
    "code": "upstream_error"
  }
}

注意事项#

1.
接口复用：图片生成使用 /v1/videos 接口，与视频生成共用；通过 model 参数区分（nano_banana 开头为图片生成）。
2.
参数位置：aspect_ratio、images 为顶层字段，直接放在请求体根对象中。
3.
参考图片格式：支持 JPEG、PNG、WEBP，单张图片最大 10MB。
4.
参考图片数量：最多 8 张。
5.
参考图片来源：
Base64：需包含完整的 Data URL 前缀（如 data:image/jpeg;base64,）
URL：直接传入可公网访问的图片地址
6.
任务模式：
不传 images 或传空数组 = 文生图
images 含图片（URL 或 Base64）= 图生图
7.
异步处理：接口返回任务 ID 后，需通过轮询查询任务进度和结果。
8.
分辨率档位：Pro 版分辨率由 model 名称后缀决定（如 nano_banana_pro-2K），无需额外传尺寸参数。

请求参数

Header 参数

Body 参数application/json必填

示例
{
  "model": "nano_banana_2",
  "prompt": "美丽的日出风景，金色的阳光洒在宁静的湖面上，远处是连绵的山脉",
  "aspect_ratio": "16:9",
  "images": [
    "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/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "model": "nano_banana_2",
  "prompt": "美丽的日出风景，金色的阳光洒在宁静的湖面上，远处是连绵的山脉",
  "aspect_ratio": "16:9",
  "images": [
    "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-07-15 03:09:31
下一页
image2（同步）
Built with