mingyan

Nano Banana - Query Task

Query the status and results of image generation tasks

GET/kyyReactApiServer/v1/result/{id}

Query Image Generation Task

Use the task ID to query the status and results of image generation tasks.

Authentication

Get Key

All requests require a Bearer token in the request header:

cURL

Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Path Parameters

idstringrequired

Unique identifier for the image generation task, returned from the create task interface

Response Parameters

idstring

Unique identifier for the image generation task

objectstring

Object type, always image.generation

createdinteger

Task creation timestamp

modelstring

Model name used

statusstring

Task status:

queued - Queued
processing - Processing
completed - Completed
failed - Failed

image_urlstring

Generated image URL, returned when status is completed

errorstring

Error message, returned when status is failed

Status Flow

queued

Task created and added to queue, waiting for processing

processing

Task is being processed, AI model is generating the image

completed

Task completed, image generated successfully, result available via image_url

Polling Recommendations

Polling Strategy:

Recommended polling interval: 2-5 seconds
Avoid overly frequent requests to prevent rate limiting
Stop polling when status is completed or failed

Image URL Information

Important:

Generated image URLs typically expire after 24 hours
Please download and save images to your storage system promptly
URLs will be inaccessible after expiration