跳转到主要内容
POST
/
api
/
v1
/
nanobanana
/
generate-2
生成图像 (Nanobanana 2)
curl --request POST \
  --url https://api.nanobananaapi.ai/api/v1/nanobanana/generate-2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "a happy dog running in the park",
  "imageUrls": [],
  "aspectRatio": "auto",
  "resolution": "1K",
  "googleSearch": false,
  "outputFormat": "jpg",
  "callBackUrl": "https://example-callback.com"
}
'
{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.nanobananaapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
重要说明

  • 响应中返回的任务 ID 用于通过获取任务详情接口查询任务状态
  • 如果提供了 callBackUrl，任务完成后会向该地址发送回调通知
  • 文本提示词 prompt 最长支持 20000 字符，建议描述清晰、具体
  • imageUrls 为空数组时为纯文本生图，填写 URL 时为图生图/参考图模式
  • 可通过 aspectRatio、resolution、outputFormat 控制生成图像的比例、清晰度和格式

​
参数概览

  • prompt：文本提示词，必填，最长 20000 字符
  • imageUrls：参考图 URL 数组，文生图时传空数组，最多 14 张
  • aspectRatio：生成图像宽高比，支持 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9、auto
  • resolution：分辨率质量，可选 1K / 2K / 4K
  • googleSearch：是否启用 Google Web Search 增强，默认 false
  • outputFormat：输出格式，支持 png / jpg，默认 jpg
  • callBackUrl：可选回调 URL，用于接收任务完成通知

授权

​
Authorization
string
header
必填

所有 API 都需要通过 Bearer Token 进行身份验证。

获取 API Key：

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法： 在请求头中添加： Authorization: Bearer YOUR_API_KEY

注意：

  • 请保护您的 API Key 安全，不要与他人分享
  • 如果您怀疑 API Key 已泄露，请立即在管理页面重置

请求体

application/json
​
prompt
string
必填

文本提示词（必填），用于控制生成图像的内容，最长 20000 字符

Maximum string length: 20000
示例:
["a happy dog running in the park"]
​
imageUrls
string<uri>[]

图像到图像模式下使用的参考图 URL。文本到图像模式下该字段为空数组。

Maximum array length: 14
​
aspectRatio
enum<string>
默认值:auto

生成图像的宽高比

可用选项:
1:1,
1:4,
1:8,
2:3,
3:2,
3:4,
4:1,
4:3,
4:5,
5:4,
8:1,
9:16,
16:9,
21:9,
auto
​
resolution
enum<string>
默认值:1K

输出分辨率质量，可选：1K、2K、4K

可用选项:
1K,
2K,
4K
​
googleSearch
boolean
默认值:false

是否启用 Google Web Search 增强，根据实时信息生成图像

​
outputFormat
enum<string>
默认值:jpg

输出图像格式

可用选项:
png,
jpg
​
callBackUrl
string<uri>

可选回调 URL，用于在任务完成时接收异步通知

响应

200 - application/json

请求成功

​
code
integer

响应状态码

示例:

200

​
message
string

响应消息

示例:

"success"

​
data
object