Skip to main content
GET
Get Task Details
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