Create Spot Translation

POST

spot-translation

curl --request POST \
  --url https://client.camb.ai/apis/spot-translation \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "run_id": 123,
  "dialogue_ids": [
    "<string>"
  ],
  "source_language": 123,
  "target_language": 123,
  "revision_num": 1,
  "generation_type": "fix_duration",
  "user_duration_percentage": 1,
  "user_prompt": "<string>"
}
'

import requests

url = "https://client.camb.ai/apis/spot-translation"

payload = {
    "run_id": 123,
    "dialogue_ids": ["<string>"],
    "source_language": 123,
    "target_language": 123,
    "revision_num": 1,
    "generation_type": "fix_duration",
    "user_duration_percentage": 1,
    "user_prompt": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    run_id: 123,
    dialogue_ids: ['<string>'],
    source_language: 123,
    target_language: 123,
    revision_num: 1,
    generation_type: 'fix_duration',
    user_duration_percentage: 1,
    user_prompt: '<string>'
  })
};

fetch('https://client.camb.ai/apis/spot-translation', 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/spot-translation",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'run_id' => 123,
    'dialogue_ids' => [
        '<string>'
    ],
    'source_language' => 123,
    'target_language' => 123,
    'revision_num' => 1,
    'generation_type' => 'fix_duration',
    'user_duration_percentage' => 1,
    'user_prompt' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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>"
    }
  ]
}

Fix a handful of lines without re-translating the project. Pass the dialogue_ids you want redone — they come from the run’s transcript — and only those are translated again. target_language names which of the run’s translations to redo, so the run must already have a transcript in it. generation_type decides what the translator may move: fix_duration keeps the new line inside the original timing, which matters when the audio is already cut to picture; rephrase lets the wording change length, with user_duration_percentage capping how far. user_prompt is a free-text instruction to the translator, for steering register and word choice. Track progress by polling /spot-translation/{task_id} with the task_id returned in the response.

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.

Headers

traceparent

string | null

Body

application/json

run_id

integer

required

The run whose dialogues are being re-translated.

dialogue_ids

string[]

required

Dialogues to re-translate, from the run's transcript.

Minimum array length: 1

source_language

integer

required

Language the dialogues are in.

target_language

integer

required

Language to translate into. The run must already have a transcript in it.

revision_num

integer | null

Revision to re-translate. Defaults to the run's latest revision.

Required range: x > 0

generation_type

enum<string>

default:fix_duration

fix_duration keeps the original timing; rephrase allows the wording to move.

Available options:

fix_duration,

rephrase

user_duration_percentage

number | null

Permitted change in duration, as a percentage of the original.

Required range: x > 0

user_prompt

string | null

Free-text instruction for the translator.

Response

Successful Response

task_id

string | null

required

Last modified on October 22, 2026

Create Spot Translation

curl --request POST \
  --url https://client.camb.ai/apis/spot-translation \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "run_id": 123,
  "dialogue_ids": [
    "<string>"
  ],
  "source_language": 123,
  "target_language": 123,
  "revision_num": 1,
  "generation_type": "fix_duration",
  "user_duration_percentage": 1,
  "user_prompt": "<string>"
}
'

import requests

url = "https://client.camb.ai/apis/spot-translation"

payload = {
    "run_id": 123,
    "dialogue_ids": ["<string>"],
    "source_language": 123,
    "target_language": 123,
    "revision_num": 1,
    "generation_type": "fix_duration",
    "user_duration_percentage": 1,
    "user_prompt": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    run_id: 123,
    dialogue_ids: ['<string>'],
    source_language: 123,
    target_language: 123,
    revision_num: 1,
    generation_type: 'fix_duration',
    user_duration_percentage: 1,
    user_prompt: '<string>'
  })
};

fetch('https://client.camb.ai/apis/spot-translation', 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/spot-translation",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'run_id' => 123,
    'dialogue_ids' => [
        '<string>'
    ],
    'source_language' => 123,
    'target_language' => 123,
    'revision_num' => 1,
    'generation_type' => 'fix_duration',
    'user_duration_percentage' => 1,
    'user_prompt' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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 Spot Translation

Authorizations

Headers

Body

Response