Skip to main content
POST
Speech transcription with automatic language detection, English translation, and optional SRT/TXT file generation. Supports 99 languages with varying accuracy levels. Cost: 8 credits
For the full list of supported languages and accuracy expectations, see Supported Languages. For a deeper dive into how transcription works and best practices, see the Transcription Guide.

Request body

string
required
Public HTTP/HTTPS URL of the video.
string
Optional ISO 639-1 language code hint (e.g. en, es, ja, ar, fr). Auto-detected if omitted. Providing a hint improves accuracy for lower-resource languages.
boolean
default:true
Translate non-English transcriptions to English. Set to false to get source-language transcription only.
string[]
Generate subtitle files and return presigned download URLs. Options: "srt", "txt". Omit for JSON-only response.
string
Optional HTTPS URL to receive a POST when processing completes.

Response (202 Accepted)

Returns a job submission with job_id. Get the result from Get Job Status with ?wait=N, or subscribe to job.completed via a webhook.

Result format

When the job completes, the results.transcription field contains the full transcription, translation, and optional file URLs.

English video (no translation needed)

Non-English video (with translation)

With subtitle files (output_formats: ["srt", "txt"])

When you include output_formats, the result includes a files object with presigned download URLs:
File URLs are presigned and expire after 1 hour. Download or store them promptly. English files are only generated when translation is performed (non-English source).

Result fields