---
title: "Fetch video task status"
method: GET
path: "/video/generations/{task_id}"
tags: ["Video"]
---

# Fetch video task status

`GET /video/generations/{task_id}`

When `status` is `SUCCESS`, `data.result_url` carries the MP4
(upstream URL, short TTL — download promptly).

## Path parameters

- `task_id` string, required

## Response `200`

Task state (wrapped envelope, uppercase status)

- VideoFetchResponse — Wrapped task envelope returned by `GET /v1/video/generations/{task_id}`. For OpenAI-style flat lowercase responses, use the alias `GET /v1/videos/{task_id}` instead.
  - `code` 'success'
  - `message` string
  - `data` object
    - `id` integer — Internal task row ID (not the public task_id).
    - `task_id` string — Public task ID (what `POST` returned).
    - `user_id` integer
    - `quota` integer — Final settled quota in OrcaRouter wallet units. Reflects upstream truth-based settlement (Kling's `final_unit_deduction` × $0.14 × wallet conversion factor).
    - `action` 'textGenerate' | 'generate' | 'omniVideo' — Resolved upstream endpoint variant — text-to-video / image-to-video / Omni-Video.
    - `status` 'NOT_START' | 'SUBMITTED' | 'IN_PROGRESS' | 'SUCCESS' | 'FAILURE' | 'UNKNOWN' — Raw task status (uppercase).
    - `progress` string — Percent string, e.g. `"30%"`, `"100%"`.
    - `submit_time` integer
    - `start_time` integer
    - `finish_time` integer
    - `result_url` string — Rendered MP4 URL. Present when `status` is `SUCCESS`. URLs are upstream-issued and may carry a short TTL — download promptly or rehost if you need long retention.
    - `fail_reason` string — Populated when `status` is `FAILURE`.
    - `properties` object
      - `origin_model_name` string — Customer-supplied model alias / namespace name.
      - `upstream_model_name` string — Upstream-resolved model (post model_mapping).

---

[API](https://skmtc.dev/orcarouter/apis/orcarouter-api.md) · [All operations](https://skmtc.dev/orcarouter/apis/orcarouter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orcarouter/orcarouter-api/revisions/9c5cc5d00311/schema)