API
Nano Banana 2 API
图片Nano Banana 2 API 将实时世界知识与高级推理能力结合，带来更强的 Prompt 理解和更准确的视觉结果。支持原生 4K、多主体一致性、灵活宽高比，并能在复杂构图中生成更稳定精细的全球化文字排版。接入 Nano Banana 2 API，构建更智能、更高质量且可规模化的图片工作流。
Body
application/jsonmodelstring必填nano-banana-2input.promptstring必填描述您希望生成的图片，或需要对参考图片进行的修改。首尾空白字符会被自动移除。
最大长度：5,000 个字符
input.imagesstring[]可选可选参考图片 URL 列表。仅支持可公开访问的 HTTPS 图片链接。文生图时可省略。
最多 14 项
input.aspect_ratiostring可选输出图片的宽高比。选择 Auto 时由模型自动决定。
默认值: auto
input.resolutionstring可选输出分辨率档位；值不区分大小写。省略或留空时使用默认值。
默认值: 2k
请求示例
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",
"input": {
"prompt": "一张未来感香蕉造型相机的电影级产品摄影",
"aspect_ratio": "1:1",
"resolution": "2k"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "nano-banana-2",
"status": "processing",
"credits": 30
}
}使用返回的任务 ID 轮询此 Endpoint，直到任务完成或失败。建议每 5 秒轮询一次，以获取最新任务状态。
POST /api/v1/check{
"task_id": "task_example"
}响应
POST /api/v1/check 返回的任务状态。以下 ID、URL 和时间戳仅用于示例。
idstring必填data.id 为任务标识，与查询请求中的 task_id 一致。
statusstring必填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",
"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",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}积分消耗
以下积分按单次请求生成一张图片计算。
| 分辨率 | 1K | 2K | 4K |
|---|---|---|---|
| 单张图片 | 20 | 30 | 40 |
省略可选参数: 20 积分
请显式传入表格列出的 input 参数，以使用对应档位。一次生成多张图片时，积分消耗可能增加。
POST /api/v1/create 响应中的 credits 字段为该任务实际扣除的积分。