图片生成接口文档

接口地址

POST /v1/videos

功能说明

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

支持的模型

model 参数	说明
`nano_banana_2`	标准版，速度快
`nano_banana_2-2K`	标准版，2K 分辨率
`nano_banana_2-4K`	标准版，4K 分辨率
`nano-banana-2.1`	Nano Banana 2.1，支持通过 `image_size` 选择 1K、2K、4K 分辨率
`nano_banana_pro-1K`	Pro 版，1K 分辨率
`nano_banana_pro-2K`	Pro 版，2K 分辨率
`nano_banana_pro-4K`	Pro 版，4K 分辨率

请求头

参数名	类型	必填	说明
Authorization	string	是	Bearer YOUR_API_KEY
Content-Type	string	是	application/json

请求参数

参数名	类型	必填	说明
model	string	是	模型名称，如 `nano_banana_2`、`nano-banana-2.1`、`nano_banana_pro-1K` 等
prompt	string	是	文本提示词，最大长度 10000 字符
aspect_ratio	string	否	宽高比，可选值：`1:1`、`9:16`、`16:9`、`3:4`、`4:3`、`3:2`、`2:3`、`5:4`、`4:5`、`21:9`、`auto`，默认 `auto`
image_size	string	否	输出分辨率档位。`nano-banana-2.1` 支持 `1K`、`2K`、`4K`；不传时使用模型默认值
images	string[]	否	参考图片数组（支持 Base64 或 URL），最多 8 张。传此参数为图生图模式，不传或传空数组为文生图模式

分辨率控制

模型	分辨率控制方式
`nano-banana-2.1`	使用顶层 `image_size` 字段，可选 `1K`、`2K`、`4K`
`nano_banana_pro-1K` / `-2K` / `-4K`	分辨率由模型名后缀决定，不需要传 `image_size`
`nano_banana_2`	使用模型默认分辨率

`images` 数组元素传法

方式	示例
图片 URL	`"https://example.com/reference.jpg"`
Base64	`"data:image/jpeg;base64,/9j/4AAQSkZJRg..."`

注意：传入图片 URL 时，网关会自动将其下载并转为 Base64 后发给上游，请确保 URL 为可公网访问的图片直链。

请求示例

Nano Banana 2.1 文生图（4K）

nano-banana-2.1 生成 1K 或 2K 图片时，只需将 image_size 改为 "1K" 或 "2K"。

文生图模式

请求体（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 格式）

响应参数

图片任务也走 /v1/videos，object 固定为 "video"。完成态图片地址位于顶层 url 和 image_url，两者值相同。

参数名	类型	说明
id	string	任务 ID，格式：`task_nano_xxx` 或 `task_xxx`
object	string	固定值：`video`（图片任务也是，类型看 `model`）
model	string	使用的模型名称
status	string	任务状态：`queued`（排队中）、`in_progress`（处理中）、`completed`（已完成）、`failed`（失败）
progress	number	任务进度，0–100
created_at	number	创建时间戳（秒）
completed_at	number	完成时间戳（秒），仅在 `failed` 或 `completed` 状态返回
url	string	生成的图片 URL（仅 `completed`）
image_url	string	与 `url` 同值（仅 `completed`）
error	object	错误信息（仅在 `failed` 状态返回）
error.message	string	失败原因描述
error.code	string	错误码，如 `upstream_error`

响应示例

提交成功（排队中）

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "nano_banana_2",
  "status": "queued",
  "progress": 0,
  "created_at": 1709876543
}

任务完成

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "nano_banana_2",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "url": "https://example.com/images/xxx.jpg",
  "image_url": "https://example.com/images/xxx.jpg"
}

任务失败

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

注意事项

接口复用：图片生成使用 /v1/videos 接口，与视频生成共用；通过 model 参数区分（nano_banana 或 nano-banana 开头为图片生成）。

参数位置：aspect_ratio、image_size、images 均为顶层字段，直接放在请求体根对象中。

参考图片格式：支持 JPEG、PNG、WEBP，单张图片最大 10MB。

参考图片数量：最多 8 张。

参考图片来源：

Base64：需包含完整的 Data URL 前缀（如 data:image/jpeg;base64,）

URL：直接传入可公网访问的图片地址

任务模式：

不传 images 或传空数组 = 文生图

images 含图片（URL 或 Base64）= 图生图

异步处理：接口返回任务 ID 后，轮询 GET /v1/videos/{task_id}。queued / in_progress 继续等；completed 读取顶层 url 或 image_url；failed 读 error.message。

分辨率档位：nano-banana-2.1 使用 image_size 控制分辨率，支持 1K、2K、4K；Pro 版分辨率由 model 名称后缀决定（如 nano_banana_pro-2K），无需额外传尺寸参数。

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

nano banana接口

图片生成接口文档

接口地址

功能说明

支持的模型

请求头

请求参数

分辨率控制

`images` 数组元素传法

请求示例

Nano Banana 2.1 文生图（4K）

文生图模式

图生图模式（URL 格式）

图生图模式（Base64 格式）

响应参数

响应示例

提交成功（排队中）

任务完成

任务失败

注意事项

请求参数

请求示例代码

返回响应

nano banana接口

图片生成接口文档#

接口地址#

功能说明#

支持的模型#

请求头#

请求参数#

分辨率控制#

images 数组元素传法#

请求示例#

Nano Banana 2.1 文生图（4K）#

文生图模式#

图生图模式（URL 格式）#

图生图模式（Base64 格式）#

响应参数#

响应示例#

提交成功（排队中）#

任务完成#

任务失败#

注意事项#

请求参数

请求示例代码

返回响应

图片生成接口文档

接口地址

功能说明

支持的模型

请求头

请求参数

分辨率控制

`images` 数组元素传法

请求示例

Nano Banana 2.1 文生图（4K）

文生图模式

图生图模式（URL 格式）

图生图模式（Base64 格式）

响应参数

响应示例

提交成功（排队中）

任务完成

任务失败

注意事项