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

获取任务详情

GET
/api/v1/nanobanana/record-info
查询 NanoBanana 任务执行详情和状态。
查询 NanoBanana 图像生成或编辑任务的状态和结果。

状态说明#

0: 生成中 - 任务正在处理中
1: 成功 - 任务完成成功
2: 创建任务失败 - 任务创建失败
3: 生成失败 - 任务创建成功但生成失败

使用指南#

使用此接口检查生成任务的当前状态
通过 successFlag 字段监控任务进度
当任务成功完成时获取生成的图像 URL
使用 errorCode 和 errorMessage 字段处理错误情况

开发者注意事项#

任务 ID 从生成或编辑图像接口的响应中获得
当 successFlag 为 1(成功)时,生成的图像 URL 可用
BFL 的原始图像 URL(originImageUrl)仅在 10 分钟内有效
我们服务器上的结果图像 URL(resultImageUrl)有更长的可用时间

Request

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

Responses

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

🟠400请求有误
🟠401没有权限
🟠404记录不存在
🔴500服务器错误
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.nanobananaapi.ai/api/v1/nanobanana/record-info?taskId=nanobanana_123456' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - 成功示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "nanobanana_task_123456",
        "paramJson": "",
        "completeTime": "",
        "response": {
            "originImageUrl": "https://bfl.com/image/original.jpg",
            "resultImageUrl": "https://ourserver.com/image/result.jpg"
        },
        "successFlag": 1,
        "errorCode": 0,
        "errorMessage": "",
        "createTime": ""
    }
}
Modified at 2026-11-11 03:43:10
Previous
生成图像 (Pro)
Built with