---
title: "GET /generate-video/status"
method: GET
path: "/generate-video/status"
---

# GET /generate-video/status

`GET /generate-video/status`

## Request

- Base URL: `https://api.nano-gpt.com/api`
- URL: `https://api.nano-gpt.com/api/generate-video/status`
- Auth: API key in header `x-api-key`

Poll the status of a video generation request submitted via /generate-video. Returns normalized status and the final video URL on completion.

## Query parameters

- `runId` string, required
- `model` string

## Response `200`

Current status for the requested video generation

- GenerateVideoStatusResponse
  - `seed` integer: The seed NanoGPT sent to the provider. Returned on completed results from models with returned seeds when the account saves request context (the default); omitted otherwise. Identical output is not guaranteed when the seed is reused.
  - `data` object
    - `status` 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELED': Current status
    - `request_id` string: Provider request identifier
    - `output` object
      - `video` object
        - `url` string: Final video URL
    - `cost` number: Final cost for the video generation
    - `error` string, nullable
    - `isNSFWError` boolean, nullable
    - `userFriendlyError` string, nullable

## Other responses

- `400`: Bad Request - Missing or invalid parameters
- `404`: Request not found

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/generate-video/status/get.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)