transcribe
Returns the full text plus time-coded segments. Stage the input with POST /v1/uploads first. ASYNCHRONOUS: the call returns 202 with a run id — poll GET /v1/runs/{id}, or register a webhook. Pass `language` when you know it: an explicit "ru" routes to a Russian-specialised engine that is an order of magnitude faster than the multilingual one, while "auto" has to use the multilingual model because the language is not known before decoding.
v1 beta server · 17 tokens
Call it
POST https://tembrica.com/v1/tools/transcribe/runs
Authorization: Bearer $TIMBRICA_KEY
Idempotency-Key: <your retry-safe key>
Content-Type: application/jsonInput
| Field | Type | Required | Notes |
|---|---|---|---|
audio | object | yes | Staged input file — audio or video. Upload it with POST /v1/uploads (multipart `file`, or JSON {"url":"…"}). The audio track is used; video is ignored. |
language | string | no |
ISO 639-1 code of the spoken language, or "auto" to detect it. Naming the language is both more accurate and, for "ru", much faster.
default: auto |
Errors it can return
validation_failed
too_long
insufficient_tokens
upstream_unavailable
History
- v1 — 2026-08-09 — Initial release (server lane, per-minute pricing).
This contract cannot change without a new version and a line above: a test compares the published schema, pricing and limits against a committed lockfile and fails the build otherwise. Subscribe to /v1/changelog to be told when something moves.
