VidLabDocs
Copy for agent
llms.txtEvery page and model as links an agent can follow.Agent setup guideThe skill, your key and what to ask for.
StatusSupportGet API key
Get startedMarkdown

Create your account

You need three things to call the VidLab API: an account, an API key and some credit. It takes a few minutes, and nothing is charged until a generation succeeds.

Sign up

Create an account on vidlab.ai. One account covers the dashboard, the Playground and the API.

Create a key

Open API keys in the dashboard, accept the Developer API terms and create a key. Give each app its own key, so you can revoke one without breaking the rest.

The full key is shown once, when you create it. Copy it somewhere safe straight away, such as a password manager or your platform's secret store. VidLab stores only a hash, so a lost key cannot be shown again: delete it and make a new one.

A new key can do everything. To narrow one, give it an expiry date, an IP allowlist, a list of allowed models or a spend limit from its menu. See Key controls.

Add credit

The API is prepaid. Open Billing, choose an amount and pay by card. The credit arrives as soon as the payment clears.

  • Each generation reserves its price while it runs. Only a success is charged, and a failed generation is free.
  • The dashboard shows credits, 100 credits to the dollar. The API speaks dollars.
  • To keep long jobs from stopping on an empty balance, turn on auto-reload.

The amounts you can add, auto-reload and refunds are on Billing.

Use your key

Put the key in an environment variable. Every example in these docs reads VIDLAB_API_KEY.

bash
export VIDLAB_API_KEY="vidlab_sk_your_key_here"

Send it as a bearer token with each request. This call reads your balance, so it is a quick way to check that the key works.

curl https://vidlab.ai/v1/balance \
  -H "Authorization: Bearer $VIDLAB_API_KEY"

Keep the key on your server. Never put it in a browser, a mobile app, a committed file or a prompt, where anyone can read it.

Next step

You have an account, a key and credit. Now make your first generation.