API & MCP for developers

The Vidova API and MCP server let you use every model from your own code or from AI assistants. They're included with the Studio plan and use your normal credits.

API keys

Create keys on Developers. Keys start with vk_live_ and are shown only once — store them safely. You can have up to 10 active keys.

Send the key in every request:

Authorization: Bearer vk_live_…

Main endpoints

• POST /api/v1/generations — start a generation; GET /api/v1/generations/{id} — check it.
• GET /api/v1/models — list models and prices.
• POST /api/v1/uploads — upload input files.
• POST /api/v1/autopilot — create an Autopilot video.
• GET /api/v1/account — your balance.

Add an Idempotency-Key header to create calls so retries never run twice.

Webhooks

Pass an https webhook_url when you create a generation. We call it on generation.succeeded and generation.failed, signed with a Vidova-Signature header, and retry up to 3 times.

Limits

60 requests per minute and 20 creates per minute per key, and up to 10 jobs in progress per key (your plan's parallel-job limit also applies).

MCP

Connect assistants like Claude to /api/mcp with the same key. Tools include list_models, estimate_cost, generate, get_generation, get_balance and create_autopilot.

Full reference with examples: API docs.