---
title: "Poll a video job"
method: GET
path: "/v1/videos/{task_id}"
tags: ["Video"]
---

# Poll a video job

`GET /v1/videos/{task_id}`

## Request

- Base URL: `https://nanostudiopro.com/api`
- URL: `https://nanostudiopro.com/api/v1/videos/{task_id}`
- Auth: HTTP bearer

Status of a video job. Polling ADVANCES the job: when Kling reports success, this call downloads and stores the MP4, settles the deferred credit deduction, and returns signed `video_url` + `preview_url` (720p). Poll every 15-30s until `completed` or `failed`.

## Response `200`

Current status; URLs present once completed.

## Other responses

- `400`: Task exists but is not a video task
- `401`: Missing or invalid token
- `404`: Task not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api.md) · [All operations](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/revisions/b454211e598e?raw)
