接口提示
nano_banana_2_lite 对应官方 Gemini 模型 gemini-3.1-flash-lite-image, 支持文生图和图像编辑
nano_banana_2_lite 针对低延迟、低成本和高并发场景进行了优化, 图片输出使用 1K 尺寸
认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: nano_banana_2_lite
prompt string 必填
文本提示词, 用于描述需要生成或编辑的图像
image_urls array
用于图像编辑的输入图片 URL 列表
aspect_ratio string
图像宽高比
可选值: 1:8, 1:4, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 8:1, 4:1, 9:16, 16:9, 21:9
image_size string
图像输出尺寸
可选值: 1K
同步生成
使用 POST /model/v1/generation/sync 发送与异步生成相同的请求体. 请求会等待任务完成并直接返回终态响应, 无需额外任务提交
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
string错误码
message
string详细错误信息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成的资源内容列表
type
string资源类型
值:
image｜videourl
string处理后的资源 URL
jobId
string远端任务 ID
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息
Nano Banana 2 Lite 的 usage 还包含以下 token 字段
prompt_tokens
integer输入提示词和图片消耗的 token 数量
completion_tokens
integer生成结果消耗的 token 数量
total_tokens
integer总 token 数量
错误码
| 错误码 | 描述 |
|---|---|
| 005001095 | 内部生成错误 |
| 005001096 | 结果解析错误 |
| 005001097 | HTTP 错误响应 |
| 005001098 | 同步生成异常 |