Translate an uploaded video

POST/v1/video-translate/generate-with-media

Stages one bounded video upload and starts an asynchronous translation request. Accepts the same settings as POST /v1/video-translate/generate as form fields. Subtitles may be sent inline in the config field or as native file parts source_srt and target_srt.<language> (for example target_srt.de); sending the same subtitle both ways is rejected. Parts may arrive in any order; validation that needs every field runs after the whole body is read but before a request is created, and the staged video is discarded on every failure. Both transports produce the same normalized, persisted config.

Limits: video 2 GiB; whole body 2 GiB + 9 MiB; part names 64 bytes; config field 6 MiB; other text fields 64 KiB; at most 11 SRT parts (one source plus one per allowed target language); each SRT part 1 MiB (rejected, never truncated); all SRTs 5 MiB. target_srt.<language> must name a supported language; invalid names are rejected before the part is read.

Body ParametersForm DataExpand Collapse

target_languages: string or array of string

JSON array (for example ["de","fr"]) or comma-separated value (de,fr).

One of the following:

string

array of string

video: file

config: optional string

JSON-encoded VideoTranslateConfig object (at most 6 MiB). SRTs may be inline here or sent as the file parts below, but not both. Resource references such as csv_resources contain metadata only; do not send CSV bytes or base64.

maxLength6291456

disable_background_audio: optional boolean

Defaults to false when omitted; set to true to disable background audio.

disable_lip_sync: optional boolean

Defaults to false when omitted; set to true to disable lip sync.

formality: optional boolean

model: optional "expressive" or "classic"

Product speech model. expressive maps to Eleven v4 and is the default; classic maps to Eleven Multilingual v2.

One of the following:

"expressive"

"classic"

reference_id: optional string

maxLength255

source_language: optional string

source_srt: optional file

Source-language SRT file part (filename must end in .srt; Content-Type empty, application/x-subrip, application/srt, text/srt, text/plain or application/octet-stream). Max 1 MiB.

webhook_url: optional string

Same terminal callback contract as VideoTranslateGenerateRequest.webhook_url.

formaturi

maxLength2048

ReturnsExpand Collapse

request_id: string

formatuuid

status: "success"

Translate an uploaded video

curl https://api.chamelaion.com/api/v1/video-translate/generate-with-media \
    -H 'Content-Type: multipart/form-data' \
    -H "Authorization: Bearer $CHAMELAION_BEARER_TOKEN" \
    -F target_languages=string \
    -F 'video=@/path/to/video' \
    -F config='{"speaker_voices":{"0":"21m00Tcm4TlvDq8ikWAM","1":"AZnzlk1XvdvUeBnXmlld"}}'

{
  "status": "success",
  "request_id": "4c98dd00-a982-47d9-a8d6-e1f0b35a8944"
}

{
  "error": "target_languages must contain at least one language"
}

{
  "error": "duplicate target language \"de\""
}

{
  "error": "input must be a video file"
}

{
  "error": "config must be a valid JSON object"
}

{
  "error": "config.source_srt is not a valid SRT file: Line 2: invalid time format, 00:00:01 --> 00:00:02, expecting in '00:00:04,139 --> 00:00:04,799' format"
}

{
  "error": "config.target_srts.fr: language \"fr\" is not listed in target_languages"
}

{
  "error": "source_srt must be supplied either in config or as a multipart file, not both"
}

{
  "error": "config.speaker_voices key \"speaker-1\" must be a non-negative integer speaker ID such as \"1\""
}

{
  "error": "speaker_voices references unknown or unavailable voice IDs: \"missing-voice\""
}

{
  "error": "missing authorization header"
}

{
  "error": "invalid authorization format"
}

{
  "error": "missing token"
}

{
  "error": "invalid token"
}

{
  "error": "unauthorized"
}

{
  "error": "multipart request exceeds the size limit (2 GiB video plus 9 MiB for form fields, config and SRT files)"
}

{
  "error": "rate limit exceeded"
}

{
  "error": "internal error"
}

Returns Examples

{
  "status": "success",
  "request_id": "4c98dd00-a982-47d9-a8d6-e1f0b35a8944"
}

{
  "error": "target_languages must contain at least one language"
}

{
  "error": "duplicate target language \"de\""
}

{
  "error": "input must be a video file"
}

{
  "error": "config must be a valid JSON object"
}

{
  "error": "config.source_srt is not a valid SRT file: Line 2: invalid time format, 00:00:01 --> 00:00:02, expecting in '00:00:04,139 --> 00:00:04,799' format"
}

{
  "error": "config.target_srts.fr: language \"fr\" is not listed in target_languages"
}

{
  "error": "source_srt must be supplied either in config or as a multipart file, not both"
}

{
  "error": "config.speaker_voices key \"speaker-1\" must be a non-negative integer speaker ID such as \"1\""
}

{
  "error": "speaker_voices references unknown or unavailable voice IDs: \"missing-voice\""
}

{
  "error": "missing authorization header"
}

{
  "error": "invalid authorization format"
}

{
  "error": "missing token"
}

{
  "error": "invalid token"
}

{
  "error": "unauthorized"
}

{
  "error": "multipart request exceeds the size limit (2 GiB video plus 9 MiB for form fields, config and SRT files)"
}

{
  "error": "rate limit exceeded"
}

{
  "error": "internal error"
}