docs.nanobananaapi.ai
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
NanoBanana API
通用API
NanoBanana API
通用API
  1. NanoBanana API
  • 欢迎使用 NanoBanana API
  • NanoBanana API 快速入门
  • 图像生成或编辑回调
  • 生成图像回调 (Nanobanana 2)
  • 生成图像 (Pro) 回调
  • 生成或编辑图像
    POST
  • 生成图像 (Nanobanana 2)
    POST
  • 生成图像 (Pro)
    POST
  • 获取任务详情
    GET
  1. NanoBanana API

生成或编辑图像

POST
/api/v1/nanobanana/generate
使用 NanoBanana AI 模型提交 Nanobanana 图像生成或编辑任务。

使用模式#

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

重要说明#

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

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200成功
application/json
请求成功
Bodyapplication/json

🟠400请求有误
🟠401没有权限
🔴500服务器错误
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '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"
}'
Response Response Example
200 - 成功示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "task12345"
    }
}
Modified at 2026-11-11 03:43:02
Previous
生成图像 (Pro) 回调
Next
生成图像 (Nanobanana 2)
Built with