Varmirdocs
Docs/Get started/Rate limits & errors

Rate limits & errors

What the API limits, and every error it can return. All errors share one JSON format, so you can handle them in one place.

Limits

WhatLimit
Upload size100 MB per file on POST /api/v1/transcribe.
Audio lengthUp to 24 hours per file.
Request rate on /transcribeNo fixed per-key limit. You pay per second of audio. If the server is at capacity, you get 503 server_busy and are not charged.
Request rate on /me, /usage, /keys30 requests per minute per key, counted separately for each endpoint.
API keysUp to 20 active keys per account.
Live streaming (WebSocket)5 concurrent streams per key; idle 30 s closes; 4 h max per stream.

Error format

Any response with a 4xx or 5xx status has this body:

HTTP
HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough quota or credits for the full duration of this audio."
  }
}

Branch on error.code: it is stable and will not change. error.message is written for people. Show it or log it, but don't parse it, because the wording can change.

Error codes

error.codeHTTPWhen it happens
invalid_request400A required field is missing or malformed, e.g. no audio file in the form.
invalid_audio400The file is empty or is not audio we can decode.
invalid_duration400The audio is zero seconds long or longer than 24 hours.
unsupported_parameter400The request uses a feature that does not exist yet, e.g. diarize.
invalid_name400Key name must be 1–50 characters (POST /keys).
invalid_days400days must be an integer from 1 to 90 (GET /usage).
invalid_api_key401The key is missing, mistyped or revoked.
insufficient_credits402Quota and credits together do not cover the full length of this file. Nothing was charged.
forbidden403This key cannot manage keys. Create one with the keys:write scope.
account_blocked403The account is blocked. Nothing is charged. Contact [email protected].
not_found404No key with this id on your account (DELETE /keys/:id).
too_many_keys409You already have 20 active keys. Revoke one first.
audio_too_large413The upload is larger than 100 MB.
rate_limited429More than 30 requests per minute to /me, /usage or /keys.
server_busy503All transcription slots are busy. Not charged.
service_unavailable503Billing or the recognition engines are temporarily down. If you were charged, the charge is refunded automatically.

Retrying

Retry only 429 and 503. Both come with a Retry-After header (in seconds), so wait that long before the next attempt. For repeated failures, double the wait each time.

Don't retry other 4xx errors as they are. The same request will fail the same way: fix the key, the file or the parameters first.

Retrying /transcribe after a 503 is safe. No charge is kept for a request that returned no transcript.