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",
  "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 张图像
  • 回调地址 (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

Response

200
application/json

请求成功

The response is of type object.