Skip to main content
GET
/
kyyAiPower
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/result/abc123def456 \
  --header 'Authorization: Bearer {{key}}'
{
  "id": "abc123def456",
  "object": "image.generation",
  "created": 1761635478,
  "model": "NanoBanana2",
  "status": "processing",
  "image_url": null,
  "error": null
}

Query Image Generation Task

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

Authentication

All requests require a Bearer token in the request header:
Authorization: Bearer {{key}}

Path Parameters

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

Response Parameters

id
string
Unique identifier for the image generation task
object
string
Object type, always image.generation
created
integer
Task creation timestamp
model
string
Model name used
status
string
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
image_url
string
Generated image URL, returned when status is completed
error
string
Error message, returned when status is failed

Status Flow

1

queued

Task created and added to queue, waiting for processing
2

processing

Task is being processed, AI model is generating the image
3

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
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/result/abc123def456 \
  --header 'Authorization: Bearer {{key}}'
{
  "id": "abc123def456",
  "object": "image.generation",
  "created": 1761635478,
  "model": "NanoBanana2",
  "status": "processing",
  "image_url": null,
  "error": null
}