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

# Create video

> POST /v1/videos

Submit a video generation job. Asynchronous: poll [Get video](/api-reference/get-video)
for the result.

```
POST https://api.heyaskr.ai/v1/videos
```

<ParamField body="model" type="string" required>Video model id.</ParamField>
<ParamField body="prompt" type="string" required>Text description.</ParamField>
<ParamField body="aspect_ratio" type="string" default="16:9">e.g. `16:9`, `9:16`.</ParamField>
<ParamField body="duration" type="string">Length in seconds, model dependent.</ParamField>

## Response

<ResponseField name="id" type="string">The job id, used to poll.</ResponseField>
<ResponseField name="status" type="string">`pending` on submit.</ResponseField>
<ResponseField name="estimated_cost" type="number">Estimated cost in USD.</ResponseField>

```json theme={null}
{ "id": "vid_...", "status": "pending", "estimated_cost": 0.35 }
```