Nano Banana: Query Image Generation Task and Result

After submitting a Nano Banana image generation task, use this endpoint to check its status and retrieve the generated image URL when complete. Because generation is asynchronous, you’ll need to poll this endpoint periodically until the task reaches a terminal state (completed or failed).

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

Endpoint

GET /v1/result/{id}

Authentication

Include your API key as a Bearer token in the Authorization header on every request:

Authorization: Bearer YOUR_API_KEY

Path Parameters

string

required

The task ID returned by the Create Image Task endpoint. Example: abc123def456.

Response Fields

string

The unique task ID for this generation job.

string

The object type. Always image.generation.

integer

Unix timestamp indicating when the task was created.

string

The model name used for this generation task.

string

The current task status.

Value	Meaning
`queued`	Task is waiting in the queue
`processing`	Task is actively being processed
`completed`	Generation succeeded — `image_url` is now available
`failed`	Generation failed — see the `error` field

string

The URL of the generated image. Only present (and non-null) when status is completed. Image URLs are valid for 24 hours — download and store the image promptly.

string

An error message describing what went wrong. Only present when status is failed.

Status Flow

Tasks move through the following states in order. Once a task reaches completed or failed, it will not change again.

queued  →  processing  →  completed
                       ↘  failed

Stage	Description
`queued`	Task has been created and is waiting for a worker
`processing`	A worker has picked up the task and is generating your image
`completed`	Image generation succeeded — retrieve the URL from `image_url`
`failed`	Image generation failed — retrieve the reason from `error`

Code Example

cURL

curl -X GET https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/abc123def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response: Processing

{
  "id": "abc123def456",
  "object": "image.generation",
  "created": 1761635478,
  "model": "nano-banana-2",
  "status": "processing",
  "image_url": null,
  "error": null
}

Response: Completed

{
  "id": "abc123def456",
  "object": "image.generation",
  "created": 1761635478,
  "model": "nano-banana-2",
  "status": "completed",
  "image_url": "https://cdn.example.com/generated/abc123def456.png",
  "error": null
}

Response: Failed

{
  "id": "abc123def456",
  "object": "image.generation",
  "created": 1761635478,
  "model": "nano-banana-2",
  "status": "failed",
  "image_url": null,
  "error": "Generation failed: content policy violation"
}

Image URLs expire in 24 hours. Once status is completed, download and save the image to your own storage immediately. After expiry, the URL will become inaccessible and the image cannot be recovered.

Polling strategy: Request the status every 2–5 seconds. Stop polling as soon as status is either completed or failed — further requests after a terminal state will return the same response without change.

Overview

Text APIs

Image APIs

Video APIs

Asset Management

Nano Banana: Query Image Generation Task and Result

Base URL

Endpoint

Authentication

Path Parameters

Response Fields

Status Flow

Code Example

Response: Processing

Response: Completed

Response: Failed

​Base URL

​Endpoint

​Authentication

​Path Parameters

​Response Fields

​Status Flow

​Code Example

​Response: Processing

​Response: Completed

​Response: Failed

Base URL

Endpoint

Authentication

Path Parameters

Response Fields

Status Flow

Code Example

Response: Processing

Response: Completed

Response: Failed