Video Generation

Query video task

Poll the status and result of a video generation task created via POST /v1/video-generation.

Call this endpoint periodically with the task_id returned from task creation. When status is Success, file_url contains the generated video URL.

Note: this endpoint’s envelope uses message, not msg as the create task endpoint does. Plan both field names when parsing.

Recommended polling schedule

Video generation averages 2+ minutes. Use this schedule to balance responsiveness and request cost:

Phase	Elapsed	Interval
Initial wait	0 – 30s	— (no requests)
Medium	30s – 2 min	every 5s
Dense	2 – 4 min	every 3s (peak)
Slow	4 – 8 min	every 8s
Idle	8 – 15 min	every 15s
Timeout	> 15 min	stop, report error

Stop polling when status is Success, Failed, or Cancelled.

GET

query

video-generation

Query video task

curl --request GET \
  --url https://api.linkmodel.ai/api/v1/query/video-generation \
  --header 'Authorization: Bearer <token>'

{
  "code": 0,
  "data": {
    "task_id": "aurora_abc123",
    "prompt": "A futuristic city at sunset",
    "file_url": "https://cdn.xxx.com/out.mp4",
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "model": "sora-2",
    "duration": 10,
    "metadata": "<string>",
    "msg": "<string>",
    "status": "Success"
  },
  "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/video-generation.

Example:

"aurora_abc123"

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>

sora-2OpenAI's flagship video and audio generation model built on a diffusion transformer architecture, featuring realistic physics simulation, synchronized audio-visual generation, and multi-shot controllability for cinematic content creation. | | | | --- | --- | | **Provider** | OpenAI | | **Tasks** | text-to-video · image-to-video | | **Starting from** | 0.3400 USD / call · <a href="https://linkmodel.ai/en/models/sora-2" target="_blank" rel="noopener">Pricing details</a> |

Query video task

curl --request GET \
  --url https://api.linkmodel.ai/api/v1/query/video-generation \
  --header 'Authorization: Bearer <token>'

{
  "code": 0,
  "data": {
    "task_id": "aurora_abc123",
    "prompt": "A futuristic city at sunset",
    "file_url": "https://cdn.xxx.com/out.mp4",
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "model": "sora-2",
    "duration": 10,
    "metadata": "<string>",
    "msg": "<string>",
    "status": "Success"
  },
  "message": "success",
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}