Skip to main content
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/image_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "image_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "image.generation",
  "created": 1774836724,
  "model": "gpt-image-2",
  "status": "processing",
  "image_url": null,
  "error": null
}

​
Query Image Generation Task

Use the task ID to query the status and results of GPT Image 2 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/kyyReactApiServer/v1/result/image_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "image_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "image.generation",
  "created": 1774836724,
  "model": "gpt-image-2",
  "status": "processing",
  "image_url": null,
  "error": null
}