Image Generation
Query image task
Poll the status and result of an image generation task created via POST /v1/image-generation.
Call this endpoint periodically with the task_id returned from task creation. When status is Success, output_images contains the generated image URLs.
Note: this endpoint’s envelope uses message, not msg as the create task endpoint does. Plan both field names when parsing.
Recommended polling schedule
Image generation averages ~1 minute (some as fast as 10s). Use this schedule to balance responsiveness and request cost:
| Phase | Elapsed | Interval |
|---|---|---|
| Initial wait | 0 – 10s | — (no requests) |
| Dense | 10s – 1 min | every 3s |
| Medium | 1 – 3 min | every 6s |
| Slow | 3 – 15 min | every 10s |
| Timeout | > 15 min | stop, report error |
Stop polling when status is Success, Failed, or Cancelled.
GET
/
query
/
image-generation
Query image task
curl --request GET \
--url https://api.linkai.one/api/v1/query/image-generation \
--header 'Authorization: Bearer <token>'{
"code": 0,
"data": {
"task_id": "aurora_xyz789",
"prompt": "A red panda coding at a laptop",
"status": "Success",
"images": [
"<string>"
],
"output_images": [
"https://cdn.xxx.com/img_1.png"
],
"model": "gemini-3-pro-image-preview",
"metadata": "<string>",
"msg": "<string>"
},
"message": "success",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Task id returned from POST /v1/image-generation.
Example:
"aurora_xyz789"
⌘I
Query image task
curl --request GET \
--url https://api.linkai.one/api/v1/query/image-generation \
--header 'Authorization: Bearer <token>'{
"code": 0,
"data": {
"task_id": "aurora_xyz789",
"prompt": "A red panda coding at a laptop",
"status": "Success",
"images": [
"<string>"
],
"output_images": [
"https://cdn.xxx.com/img_1.png"
],
"model": "gemini-3-pro-image-preview",
"metadata": "<string>",
"msg": "<string>"
},
"message": "success",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}