# Get Video Task

`GET /v1/videos/tasks/{id}`

Check a video task and collect the finished clip.

Poll every 10 to 15 seconds. When `status` is `succeeded`, `output.video_url` holds a durable CDN URL.

Base URL: `https://api.spicyapi.com`

## Authorizations

- `Authorization` (string, header, required): Bearer authentication header of the form `Bearer <token>`, where `<token>` is your SpicyAPI key (`sk-spicy-…`). Create one in the dashboard under API Keys.

## Request

```bash
curl --request GET \
  --url https://api.spicyapi.com/v1/videos/tasks/task_5d9e2f10 \
  --header 'Authorization: Bearer $SPICYAPI_KEY'
```

## Response: 200 application/json

Successful Response

- `id` (string, required): The task id.
- `status` (string, required): `queued`, `processing`, `finalizing`, `succeeded`, or `failed`.
- `output` (object | null, optional): Present once finished.
  - `video_url` (string, required): Durable CDN URL of the clip.
- `error` (string | null, optional): Failure reason, if any. Failed tasks are refunded.
- `cost_usd` (number, required): What this request cost, in US dollars, already debited from your balance.

```json
{
  "id": "task_5d9e2f10",
  "object": "task",
  "type": "video",
  "model": "spicy-pov-missionary-1",
  "status": "succeeded",
  "output": {
    "video_url": "https://cdn.spicyapi.com/outputs/a1b2/task_5d9e2f10.mp4"
  },
  "error": null,
  "cost_usd": 0.875
}
```