# What your agent can do

With the [VidLab skill](https://docs.vidlab.ai/agent-skill) and your key, your agent uses the same API you do. Each line below is one or two calls it makes for you; nothing here needs a dashboard.

| Ask for | What it does | Calls |
| - | - | - |
| Images | Picks an image model, prices it, makes one or more images, saves them. | `POST /v1/generations` |
| Video from text or a picture | Picks a video model, sends your prompt and first frame, polls until done. | `POST /v1/uploads`, `POST /v1/generations` |
| Voice-overs and music | Text to speech, dialogue and songs on the audio models. | `POST /v1/generations` |
| Lip sync and upscales | Sends your clip and sound, priced on their real length. | `POST /v1/uploads`, `POST /v1/generations` |
| A finished ad | Runs one of our [formats](https://docs.vidlab.ai/formats): answers its questions with you, asks you to approve the price, returns the video. | `POST /v1/formats/{format_id}/runs` |
| Prices and options | Lists models for a task, reads their options, prices a request. Free. | `GET /v1/models`, `POST /v1/estimate` |
| Your balance | Says what you can spend before a large job. Free. | `GET /v1/balance` |
| Your history | Lists your recent generations and their results. Free. | `GET /v1/generations` |
| VidLab in your app | Adds a small server-side client and moves your app's generation calls to VidLab, keeping your models. | the same calls, in your code |

## How it keeps your money safe

- **Price first.** It prices the exact request (`POST /v1/generations/quote`, free, nothing held) and tells you before it runs anything paid. It asks when the price is more than you would expect.
- **A cap on every run.** It sends `max_cost_usd`, so no route dearer than your price can run it.
- **No double charges.** Every run carries an `Idempotency-Key`; a retry after a network error returns the same job.
- **Failures are free.** A generation that fails costs $0.00; the agent reads why and tells you.

## What it will not do

- Invent a model id, an option or a price: they come from the live model list.
- Print your key, write it into a file or a command, or ask you to paste it.
- Spend without telling you the price first.

## Example requests

```text
Use VidLab to make three 1:1 product shots of a red sneaker on white. Tell me the price first.
```

```text
Make a 5 second 9:16 video from ./product.png with VidLab: a slow push-in, soft light. Cap it at $1.
```

```text
Turn this script into a voice-over with VidLab and save it as voiceover.mp3: "Asleep in 20 minutes. No grogginess."
```

```text
Add VidLab to this app. Move our current image generation over to it and run one test call when I say so.
```