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.linkmodel.ai/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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

task_id

string

required

Task id returned from POST /v1/image-generation.

Example:

"aurora_xyz789"

Response

Query result with current task status.

code

integer

Example:

0

data

object

Show child attributes

message

string

Envelope-level status. This endpoint uses message (create task uses msg).

Example:

"success"

request_id

string<uuid>

happyhorse-1.0Alibaba ATH Innovation Unit's 15B video model — the first with native joint audio-video generation including dialogue, ambient sound, and lip-sync — #1 on the Artificial Analysis Video Arena, built for short-form, ads, and dialogue-driven video. | | | | --- | --- | | **Provider** | Alibaba | | **Tasks** | text-to-video · image-to-video | | **Starting from** | 0.1158 USD / second · <a href="https://linkmodel.ai/en/models/happyhorse-1.0" target="_blank" rel="noopener">Pricing details</a> |

Query image task

curl --request GET \
  --url https://api.linkmodel.ai/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"
}