跳转到主要内容
POST
/
api
/
v1
/
nanobanana
/
generate
生成或编辑图像
curl --request POST \
  --url https://api.nanobananaapi.ai/api/v1/nanobanana/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "夕阳下宁静的山景，湖面倒映着橙色的天空",
  "numImages": 1,
  "type": "TEXTTOIAMGE",
  "image_size": "16:9",
  "callBackUrl": "https://your-callback-url.com/callback"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task12345"
  }
}

​
使用模式

  1. 文本到图像生成
    • 提供 prompt 并将 type 设置为 “TEXTTOIAMGE”
    • 模型将根据文本描述生成新图像
  2. 图像到图像编辑
    • 提供 prompt、imageUrls 并将 type 设置为 “IMAGETOIAMGE”
    • 模型将根据提示编辑输入图像

​
重要说明

  • 使用 numImages 参数每次请求可以生成 1-4 张图像
  • 使用 image_size 参数指定图像的宽高比
  • 回调地址 (callBackUrl) 是必填的，用于接收任务完成通知
  • 任务完成后将通过 POST 请求发送结果到您的回调地址
  • 如需轮询任务状态，可使用获取任务详情接口
  • 根据您的需求选择合适的生成类型：
    • TEXTTOIAMGE：文本到图像生成
    • IMAGETOIAMGE：使用输入图像进行图像编辑

Authorizations

​
Authorization
string
header
required

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

获取 API Key：

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

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

注意：

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

Body

application/json
​
prompt
string
required

生成内容的提示词

Example:

"夕阳下宁静的山景，湖面倒映着橙色的天空"

​
type
enum<string>
required

生成类型：

  • TEXTTOIAMGE: 文本到图像
  • IMAGETOIAMGE: 图像编辑
可用选项:
IMAGETOIAMGE,
TEXTTOIAMGE
Example:

"TEXTTOIAMGE"

​
callBackUrl
string<uri>
required

回调地址，用于接收任务完成通知（必填）

Example:

"https://your-callback-url.com/callback"

​
numImages
integer
default:1

生成图片数量，最小值为 1，最大值为 4

Required range: 1 <= x <= 4
Example:

1

​
imageUrls
string<uri>[]

用于图像编辑模式的输入图像 URL 数组

Example:
["https://example.com/input-image.jpg"]
​
watermark
string

添加到生成图像上的水印文字

Example:

"NanoBanana"

​
image_size
enum<string>

图像宽高比。支持的比例：

  • 1:1: 正方形
  • 9:16: 竖屏（手机）
  • 16:9: 横屏（宽屏）
  • 3:4: 竖屏
  • 4:3: 横屏（传统）
  • 3:2: 横屏（照片）
  • 2:3: 竖屏（照片）
  • 5:4: 竖屏（接近正方形）
  • 4:5: 竖屏（接近正方形）
  • 21:9: 超宽横屏
可用选项:
1:1,
9:16,
16:9,
3:4,
4:3,
3:2,
2:3,
5:4,
4:5,
21:9
Example:

"1:1"

Response

请求成功

​
code
enum<integer>

响应状态码

  • 200: 成功
  • 400: 参数错误
  • 401: 未授权
  • 500: 服务器内部错误
可用选项:
200,
400,
401,
500
​
msg
string

响应消息

Example:

"success"

​
data
object