API 文档模型文档

Nano Banana Pro API

Gemini 3 Pro Image: studio-quality output with reasoning, up to 4K.

POST/api/v1/generations需要 Bearer API Key

nano-banana-pro图片 · Google模型详情与价格

此模型使用的接口

POST/generations创建生成任务 POST/images/generationsOpenAI 兼容生图 GET/generations/{id}获取结果 POST/generations/{id}/cancel取消任务 POST/quote报价 GET/models/{slug}查询单个模型

参数范围

选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。

请求

cURL

curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-pro",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  }
}'

输入参数

JSON 请求体

调用 /generations 和 /quote 时，将以下参数放入 input；调用 /images/generations 时放在顶层；对话参数放在 /chat/completions 顶层。

model string必填: 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。
可选值:"nano-banana-pro"
input object必填: 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。
provider string可选: 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。
project string可选: 可选项目 ID，使用该项目公开的模型目录和路由配置。
callback_url string<uri>可选: 公开 HTTPS 地址，最长 1,000 字符。接收最终任务对象，不允许内网地址。
input.prompt string必填
input.image_urls string<uri>[]可选: Optional — switches to image editing
最多数量:14
input.aspect_ratio enum可选: 默认值:"1:1"
可选值:"1:1""16:9""9:16""4:3""3:4""3:2""2:3""4:5""5:4""21:9"
input.resolution enum可选: 默认值:"1K"
可选值:"1K""2K""4K"
input.num_images integer可选: 默认值:1
最小值:1
最大值:4

响应示例

200 · application/json

{
  "id": "gen_example",
  "object": "generation",
  "model": "nano-banana-pro",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

响应仅用于说明结构；ID、用量、价格和结果以实际请求为准。

输出字段

id string: 创建任务返回的生成 ID。
object "generation": generation
model string: 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。
type video | image | audio | chat
provider string: 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。
status string: queued（排队）/ processing（处理中）/ succeeded（成功）/ failed（失败）。成功或失败后停止轮询。
input object: 模型专属的输入对象。必填字段、默认值和限制见对应模型文档。
outputs string[]: 结果文件 URL 列表；结果未就绪时为空。链接可能过期，请及时下载。
error string | null: 失败时的错误信息，否则为 null。
credits number: 该任务扣除的积分，退款后为 0。
price_usd number: 该任务的美元价格，退款后为 0。
created_at string: ISO 8601 格式的创建时间。
completed_at string | null: ISO 8601 格式的完成时间，进行中为 null。

使用说明

轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。

给 AI 使用

把文档索引或完整接口文档交给 AI 编程助手，包含实时模型参数。

llms.txt llms-full.txt 此页 Markdown