跳转到主要内容
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. 图像到图像编辑
    • 提供 promptimageUrls 并将 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