Plans & Limits
The Vidocu API is part of your Vidocu plan - there's no separate API subscription. API usage draws from the same monthly video-minute allowance as the app.
Getting access
- REST API (API keys) - available on the Business plan and above.
- Claude / MCP integration (OAuth) - available on any plan. See MCP.
Both authenticate the same way and consume the same video-minute allowance.
Limits
| Limit | Business | Enterprise |
|---|---|---|
| Video minutes / month | 60 (shared with the app) | Custom |
| Max video duration / request | 10 min | Custom |
| Requests per minute | 60 | 60 |
| API keys / workspace | 10 | 10 |
| Webhooks | Yes | Yes |
Every API operation is available once you have access - there's no per-feature gating. Need more minutes? Buy add-on minute packs from the dashboard, or talk to us about Enterprise.
How operations consume minutes
Usage is metered in video minutes, drawn from your plan's monthly allowance:
| Operation | Cost |
|---|---|
| Analyze | 1 min per video minute |
| Translate | 1 min per video minute, per target language |
Voiceover (/voiceover) | 1 min per video minute |
| Export | Free |
| Help article | Free |
| Tools | Free |
The one-shot /process pipeline bills the analysis step once. Generating voiceover, exports, or help articles within the same /process call doesn't add charges.
When you run out
Once you've used your monthly video minutes, minute-consuming requests return 403 until your next billing cycle. There's no overage:
{
"error": {
"code": "limit_exceeded",
"message": "Video minutes quota exceeded. Used 60 of 60 minutes this period. Quota resets at the start of your next billing cycle."
}
}
Checking your usage
Use the Usage endpoint to see current consumption and limits:
curl https://api.vidocu.ai/v1/usage \
-H "Authorization: Bearer vdo_live_your_key_here"
Upgrading
Manage your plan from the Vidocu Dashboard. Changes take effect immediately.