Skip to main content
GET
/
api
/
v1
/
nanobanana
/
record-info
Get Task Details
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": ""
  }
}
Query the status and results of a NanoBanana image generation or editing task.

​
Status Descriptions

  • 0: GENERATING - Task is currently being processed
  • 1: SUCCESS - Task completed successfully
  • 2: CREATE_TASK_FAILED - Failed to create the task
  • 3: GENERATE_FAILED - Task creation succeeded but generation failed

​
Usage Guide

  • Use this endpoint to check the current status of your generation task
  • Monitor task progress using the successFlag field
  • Retrieve generated image URLs when task is completed successfully
  • Handle error cases using errorCode and errorMessage fields

​
Developer Notes

  • Task ID is obtained from the Generate or Edit Image endpoint response
  • Generated images URLs are available when successFlag is 1 (SUCCESS)
  • Original image URL (originImageUrl) from BFL is valid for 10 minutes only
  • Result image URL (resultImageUrl) on our server has longer availability

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Query Parameters

​
taskId
string
required

Task ID (required)

Response

Request successful

​
code
enum<integer>

Response status code

  • 200: Success
  • 400: Parameter error
  • 401: Unauthorized
  • 404: Task not found
  • 500: Server internal error
Available options:
200,
400,
401,
404,
500
​
msg
string

Response message

Example:

"success"

​
data
object
⌘I