跳转到主要内容
GET
/
api
/
v1
/
nanobanana
/
record-info
获取任务详情
curl --request GET \
  --url https://api.nanobananaapi.ai/api/v1/nanobanana/record-info \
  --header 'Authorization: Bearer <token>'
{
  "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": ""
  }
}
查询 NanoBanana 图像生成或编辑任务的状态和结果。

​
状态说明

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

​
使用指南

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

​
开发者注意事项

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

Authorizations

​
Authorization
string
header
required

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

获取 API Key：

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

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

注意：

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

Query Parameters

​
taskId
string
required

任务 ID（必填）

Response

请求成功

​
code
enum<integer>

响应状态码

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

响应消息

Example:

"success"

​
data
object