> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inquantum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Video Generation

> Submit, poll, and download asynchronous video generations.

## Submit a Video

```text theme={null}
POST https://api.inquantum.ai/v1/videos
```

| Field            | Type    | Required       | Description                                                           |
| ---------------- | ------- | -------------- | --------------------------------------------------------------------- |
| `model`          | string  | Yes            | Exact video model ID from the model registry.                         |
| `prompt`         | string  | Yes            | Non-empty description of the requested video.                         |
| `duration`       | number  | Model-specific | Duration in seconds using the canonical gateway field.                |
| `resolution`     | string  | No             | Model-supported resolution such as `720p`.                            |
| `aspect_ratio`   | string  | No             | Model-supported ratio such as `16:9`.                                 |
| `size`           | string  | No             | Exact model-supported pixel size. Do not combine with `aspect_ratio`. |
| `generate_audio` | boolean | No             | Generate audio when supported by the selected endpoint.               |
| `seed`           | integer | No             | Reproducibility seed when supported.                                  |

Additional fields, including image inputs, are accepted only when listed by the selected model contract. Unknown fields are rejected.

```bash theme={null}
curl https://api.inquantum.ai/v1/videos \
  -H "Authorization: Bearer $PLANCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/alibaba/wan-2.6",
    "prompt": "A paper airplane gliding above a quiet city at sunrise",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false
  }'
```

The submit endpoint returns `202 Accepted`:

```json theme={null}
{
  "id": "planck-video-job-id",
  "object": "video.generation.job",
  "status": "pending",
  "model": "alibaba/wan-2.6",
  "provider": "openrouter",
  "polling_url": "/v1/videos/planck-video-job-id"
}
```

## Get Job Status

```text theme={null}
GET https://api.inquantum.ai/v1/videos/{job_id}
```

The response includes `status`, `outputs`, `usage`, `cost`, timestamps, and an `error` object when the generation fails.

## Download Content

```text theme={null}
GET https://api.inquantum.ai/v1/videos/{job_id}/content
GET https://api.inquantum.ai/v1/videos/{job_id}/content?index=0
```

The content route returns or redirects to the selected output. Use a valid Planck API key for the organization that submitted the generation.

See the [Video Generation guide](/gateway/video-generation) for the complete workflow, validation, billing, and tracking behavior.