Skip to main content

Inputs & Outputs

Input:
  • media_url
  • source language & target language
  • [optional] subtitle_url or ocr_text_box (for more accurate speech recognition)
  • [optional] glossary_ids
Glossary Pn Output:
  • media (video or audio)
  • translated subtitle_url (SRT)

How it works

1

Host your assets at a publicly accessible URL

Upload your video or audio, and optional subtitle (.srt) so our servers can retrieve them.
2

Optionally provide OCR text region

If there is on‑screen text to translate, specify a normalized OCR box (x, y, width, height) from 0–1; origin at the top‑left of the frame.
3

Send an API request with the appropriate parameters

Include source/target languages (e.g., en‑US → zh‑CN), speaker range if needed, and export type.
4

Wait or query status

Use our webhook callback or poll the API with your task ID until processing is complete.
5

Download outputs

Retrieve translated video/audio and the translated subtitle (.srt) from the provided URLs.

Usage Limitation

  • Only users who can create API Keys may use this API.
  • Studio plan is required; non‑Studio users are not allowed.
  • Concurrency is limited independently from LipSync; queued requests are counted.
  • Language code follows IETF BCP 47 standard, e.g., en‑US.

API Error Codes

Job Error Codes

Supported Languages

Source Languages

Note: “auto” is supported to automatically detect the source language and update SourceLanguage when detected.

Target Languages

Last modified on May 26, 2026