Create a translation

Translates plain text, a WebVTT subtitle, or a MamuteCloud transcription into up to 10 languages.

The call waits up to about 20 seconds: a short text comes back 200 with status: "done" and the translations. Anything longer answers 202 with status: "queued" or "processing"; read the result with GET /v1/translations/{id} or receive it on webhookUrl. Send ?wait=false to always answer at once.

Text keeps its line breaks. WebVTT keeps every cue and its timing: cues that split a sentence are translated together and the translation is spread back over them. With transcriptId the transcription's WebVTT is translated and its detected language is the source.

Pricing: US$ 1 per million characters, per target language: billedCharacters = source characters (spaces count; for WebVTT only the cue text, without timings or tags) x number of targets. Charged only when the translation is done; failed translations are not charged. Requires paid balance or auto-recharge; trial credit does not apply. The price is held from the balance once the characters are counted: a translation the balance cannot cover ends in error with insufficient_balance: ... and costs nothing.

Limits: text up to 500,000 characters, WebVTT up to 1,000,000, 10 targets per job. Results are kept for 7 days.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

false answers at once with the translation queued

Allowed:
Body Params

Send exactly one of text, vtt or transcriptId.

string

Plain text, up to 500,000 characters. Line breaks are kept.

string

WebVTT document (starting with WEBVTT), up to 1,000,000 characters. Comes back as WebVTT with the same cues and timings.

uuid

A done transcription of the same organization, within its 7 days. Comes back as WebVTT.

string

Language of the input (pt, en, pt-BR, por_Latn, ...). Required for text and vtt; for transcriptId it defaults to the transcription's language.

targets
array of strings
required
length between 1 and 10

Languages to translate into, unique, none equal to the source

targets*
uri

Called with POST { "data": { "id", "status" } } when the translation ends (done or error), retried with backoff for about 7 hours while it does not answer 2xx (header X-Mamute-Webhook-Attempt).

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json