API
Nano Banana 2 Lite API
图片Nano Banana 2 Lite API 提供快速高效的图片生成，支持稳定的角色一致性、自然的多图融合以及自然语言编辑，适合日常创意工作流。接入 Nano Banana 2 Lite API，即可获得轻量、高质量的视觉生成能力。
Body
application/jsonmodelstring必填nano-banana-2-liteinput.promptstring必填描述您希望生成的图片，或需要对参考图片进行的修改。首尾空白字符会被自动移除。
最大长度：5,000 个字符
input.imagesstring[]可选可选参考图片 URL 列表。仅支持可公开访问的 HTTPS 图片链接。文生图时可省略。
最多 14 项
input.aspect_ratiostring可选输出图片的宽高比。选择 Auto 时由模型自动决定。
默认值: auto
auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1
请求示例
POST /api/v1/createcurl -X POST https://nanobanana.io/api/v1/create \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2-lite",
"input": {
"prompt": "一张未来感香蕉造型相机的电影级产品摄影"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "nano-banana-2-lite",
"status": "processing",
"credits": 18
}
}使用返回的任务 ID 轮询此 Endpoint，直到任务完成或失败。建议每 5 秒轮询一次，以获取最新任务状态。
POST /api/v1/check{
"task_id": "task_example"
}响应
POST /api/v1/check 返回的任务状态。以下 ID、URL 和时间戳仅用于示例。
idstring必填data.id 为任务标识，与查询请求中的 task_id 一致。
statusstring必填completed 表示生成成功，data.data 包含生成结果；其他状态下 data.data 为 null。
failed_reasonstring可选仅当 status 为 failed 时返回，用于说明失败原因。completed 和 processing 状态不包含此字段。
已完成 · completed
下载链接位于 data.data.results。
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "nano-banana-2-lite",
"status": "completed",
"data": {
"results": [
"https://example.com/generated.png"
],
"processing_time": 18
}
}
}其他状态
processing 或 failed 状态下，data.data 为 null。以下以 failed 为例：只有 failed 才包含 failed_reason。processing 时继续轮询，failed 时停止轮询。
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "nano-banana-2-lite",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}积分消耗
以下积分按单次请求生成一张图片计算。
| 生成方式 | 每次请求的积分 |
|---|---|
| 单张图片 | 18 |
请显式传入表格列出的 input 参数，以使用对应档位。一次生成多张图片时，积分消耗可能增加。
POST /api/v1/create 响应中的 credits 字段为该任务实际扣除的积分。