# Quickstart

One key, one request shape, every image, video and audio model. Submit a job, poll it, get the file.

> **Live.** Every model on the [models page](/vidlab-api/models) runs on this one endpoint. Options and prices are in `GET /v1/models`.

> **New.** `POST /v1/generations/quote` prices the exact request first, `max_cost_usd` caps it, and `POST /v1/uploads` takes your own files.

| | |
| - | - |
| Base URL | `https://vidlab.ai/v1` |
| Auth | `Authorization: Bearer $VIDLAB_API_KEY`. Make a key on [API keys](/vidlab-api/api-keys). |
| Submit | `POST /v1/generations` |
| Poll | `GET /v1/generations/{id}` |
| Download | `GET /v1/generations/{id}/content` |
| Price | `POST /v1/generations/quote` (free, nothing held) |
| Models | `GET /v1/models` (no key) |
| Balance | `GET /v1/balance` |
| Upload | `POST /v1/uploads` |
| Format | JSON in, JSON out. Prices are US dollars; the dashboard shows credits, 100 credits = $1. |
| Machine-readable | [`/v1/openapi.json`](https://vidlab.ai/v1/openapi.json), [`/vidlab-api/llms.txt`](https://vidlab.ai/vidlab-api/llms.txt), [`/vidlab-api/llms-full.txt`](https://vidlab.ai/vidlab-api/llms-full.txt), [`/vidlab-api/SKILL.md`](https://vidlab.ai/vidlab-api/SKILL.md) |

Every page of these docs is also Markdown: add `.md` to its URL, for example [https://vidlab.ai/vidlab-api/docs/quickstart.md](https://vidlab.ai/vidlab-api/docs/quickstart.md).