Create Document Translation

POST

translate-doc

curl --request POST \
  --url https://client.camb.ai/apis/translate-doc \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form source_language=en-us \
  --form target_language=fr-fr \
  --form media_file=@example-file \
  --form media_url= \
  --form 'translation_style=<string>'

import requests

url = "https://client.camb.ai/apis/translate-doc"

files = { "media_file": ("example-file", open("example-file", "rb")) }
payload = {
    "source_language": "en-us",
    "target_language": "fr-fr",
    "media_url": "",
    "translation_style": "<string>"
}
headers = {"x-api-key": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('source_language', 'en-us');
form.append('target_language', 'fr-fr');
form.append('media_file', '<string>');
form.append('media_url', '');
form.append('translation_style', '<string>');

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

options.body = form;

fetch('https://client.camb.ai/apis/translate-doc', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/translate-doc",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"source_language\"\r\n\r\nen-us\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"target_language\"\r\n\r\nfr-fr\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media_url\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"translation_style\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "task_id": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Use this endpoint when you want to translate a document file instead of an array of text strings. Submit a document with its source and target languages, and CAMB.AI starts an asynchronous document translation task. The response includes a task_id. Poll Get Document Translation Status until the task reaches SUCCESS, then use the returned run_id with Get Document Translation Result to retrieve the translated document download URL.

Response

The create response contains only the task identifier:

task_id: the identifier for the asynchronous document translation task.

It does not return a run_id at creation time. The run_id is available from Get Document Translation Status once the task reaches SUCCESS.

{
  "task_id": "7f1b7a4c-8e6d-4c1a-9a5d-2f0f9d8c1234"
}

Supported Inputs

Provide either:

media_file: upload the document directly as multipart form data.
media_url: provide a URL to the document file.

Supported document formats include DOCX and SRT. DOCX is useful for document workflows where the translated output should remain a downloadable document. SRT is useful when you already have subtitle timing and want the subtitle text translated while keeping the file-based workflow.

Language and Terminology

source_language: the language of the source document.
target_language: the language to translate into.
chosen_dictionaries: optional dictionary IDs to enforce approved terminology.
translation_style: optional guidance for tone, wording, or terminology preferences. Omit this field when you do not need custom style instructions.

Use Get Source Languages and Get Target Languages to find supported language tags and IDs.

DOCX Example

import requests

API_KEY = "your-api-key"
BASE_URL = "https://client.camb.ai/apis"

headers = {"x-api-key": API_KEY}

with open("source.docx", "rb") as document:
    response = requests.post(
        f"{BASE_URL}/translate-doc",
        headers=headers,
        data={
            "source_language": "en-us",
            "target_language": "fr-fr",
        },
        files={
            "media_file": (
                "source.docx",
                document,
                "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
            )
        },
    )

response.raise_for_status()
task = response.json()
print(task["task_id"])

SRT Example

import requests

API_KEY = "your-api-key"
BASE_URL = "https://client.camb.ai/apis"

headers = {"x-api-key": API_KEY}

with open("captions.srt", "rb") as subtitles:
    response = requests.post(
        f"{BASE_URL}/translate-doc",
        headers=headers,
        data={
            "source_language": "en-us",
            "target_language": "es-es",
        },
        files={
            "media_file": (
                "captions.srt",
                subtitles,
                "application/x-subrip",
            )
        },
    )

response.raise_for_status()
task = response.json()
print(task["task_id"])

Document translation is asynchronous. Store the task_id from this response so you can poll task status and fetch the final download URL.

Authorizations

x-api-key

string

header

required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Body

multipart/form-data

source_language

string

required

Source language of the document. Pass a locale tag (en-us, fr-fr, es-es). Numeric language IDs (1 or "1") still work but are deprecated. See all source languages.

Example:

"en-us"

target_language

string

required

Target language for the translated document. Pass a locale tag (fr-fr, es-es, de-de). Numeric language IDs still work but are deprecated. See all target languages.

Example:

"fr-fr"

project_name

string | null

Enter a distinctive name for your project that reflects its purpose or content. This name will be displayed in your CAMB.AI workspace dashboard and used to organize related assets, transcriptions, etc.. . Choose something memorable that helps you quickly identify this specific project among your other voice, audio and localization tasks.

Required string length: 3 - 255

Example:

null

project_description

string | null

Provide details about your project's goals and specifications. Include information such as the target languages for translation or dubbing, desired voice characteristics, emotional tones to capture, or specific audio processing requirements, outlining the workflow here can serve as valuable documentation for organizational purposes.

Required string length: 3 - 5000

Example:

null

media_file

file

Document file to translate. Supported formats include DOCX and SRT. Leave blank when using media_url.

media_url

string<uri>

URL to a document file for translation. Leave blank when uploading media_file.

Example:

""

chosen_dictionaries

integer[] | null

Optional dictionaries to apply during document translation.

Minimum array length: 1

translation_style

string | null

Optional free-text guidance for the translation style.

Response

Successful Response

task_id

string

required

Last modified on November 11, 2026

Create Document Translation

curl --request POST \
  --url https://client.camb.ai/apis/translate-doc \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form source_language=en-us \
  --form target_language=fr-fr \
  --form media_file=@example-file \
  --form media_url= \
  --form 'translation_style=<string>'

import requests

url = "https://client.camb.ai/apis/translate-doc"

files = { "media_file": ("example-file", open("example-file", "rb")) }
payload = {
    "source_language": "en-us",
    "target_language": "fr-fr",
    "media_url": "",
    "translation_style": "<string>"
}
headers = {"x-api-key": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('source_language', 'en-us');
form.append('target_language', 'fr-fr');
form.append('media_file', '<string>');
form.append('media_url', '');
form.append('translation_style', '<string>');

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

options.body = form;

fetch('https://client.camb.ai/apis/translate-doc', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/translate-doc",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"source_language\"\r\n\r\nen-us\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"target_language\"\r\n\r\nfr-fr\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media_file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"media_url\"\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"translation_style\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "task_id": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Create Document Translation

Response

Supported Inputs

Language and Terminology

DOCX Example

SRT Example

Authorizations

Body

Response

​Response

​Supported Inputs

​Language and Terminology

​DOCX Example

​SRT Example

Authorizations

Body

Response

Response

Supported Inputs

Language and Terminology

DOCX Example

SRT Example