Fetch Subtitle Results

POST

sub-results

Get Subtitle Results

curl --request POST \
  --url https://client.camb.ai/apis/sub-results \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "run_ids": [
    12345,
    6789
  ]
}
'

import requests

url = "https://client.camb.ai/apis/sub-results"

payload = { "run_ids": [12345, 6789] }
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_ids: [12345, 6789]})
};

fetch('https://client.camb.ai/apis/sub-results', 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/sub-results",
  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_ids' => [
        12345,
        6789
    ]
  ]),
  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;
}

{}

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

Fetches subtitle results for several runs in one request. Each run’s value matches Get Subtitle Result: structured JSON by default, or exported srt/vtt/txt when you pass format_type and/or data_type.

By default (no query params) each run returns structured JSON: one language → { "transcript": [ ... ] }; many → object keyed by language ID.
When you pass format_type and/or data_type, each run is exported the same way as Get Subtitle Result: one language → { "transcript": <url|text> }; many → { "<lang_id>": { "transcript": <url|text> }, ... }.

Choosing your output

Parameter	Values	Behaviour
(none)	n/a	Per run: structured JSON transcript(s)
`data_type=file`	`srt` / `vtt` / `txt` via `format_type` (default `txt`)	Per run: presigned file URL(s)
`data_type=raw_data`	`srt` / `vtt` / `txt` via `format_type` (default `txt`)	Per run: rendered text inline

Same format_type / data_type values as Get Transcription Result and Get Subtitle Result.

Request

{
  "run_ids": [12345, 12346, 12347, 12348]
}

Response Structure

The API returns an object keyed by run_id.

Default (no export params)

{
  "12345": {
    "transcript": [
      { "start": 0.0, "end": 2.5, "speaker": "SPEAKER_0", "text": "Welcome to our discussion on AI." }
    ]
  },
  "12346": {
    "1": {
      "transcript": [
        { "start": 0.0, "end": 2.5, "speaker": "SPEAKER_0", "text": "Welcome to our discussion on AI." }
      ]
    },
    "23": {
      "transcript": [
        { "start": 0.0, "end": 2.7, "speaker": "SPEAKER_0", "text": "Bienvenidos a nuestra discusión sobre IA." }
      ]
    }
  }
}

Field	Description
`start`	Start time of the segment (seconds)
`end`	End time of the segment (seconds)
`text`	Text for this segment, in that language
`speaker`	Speaker identifier

Export (`format_type` / `data_type`)

{
  "12345": { "transcript": "https://storage.example.com/.../output_transcript.srt?..." },
  "12346": {
    "1":  { "transcript": "https://storage.example.com/.../en_us/output_transcript.srt?..." },
    "23": { "transcript": "https://storage.example.com/.../es_es/output_transcript.srt?..." }
  }
}

Presigned file URLs expire after 24 hours.

Implementation Example

import requests

headers = {
    "x-api-key": "your-api-key",
    "Content-Type": "application/json",
}

API_URL = "https://client.camb.ai/apis/sub-results"
run_ids = [12345, 12346, 12347, 12348]

# Default: structured JSON per run
bulk = requests.post(API_URL, headers=headers, json={"run_ids": run_ids}).json()
for run_id, run_result in bulk.items():
    if "transcript" in run_result:
        print(f"Run {run_id}: {len(run_result['transcript'])} segments")
    else:
        for language_id, payload in run_result.items():
            print(f"Run {run_id} / lang {language_id}: {len(payload['transcript'])} segments")

# Export: SRT file URLs for every language on every run
srt_bulk = requests.post(
    API_URL,
    headers=headers,
    params={"format_type": "srt", "data_type": "file"},
    json={"run_ids": run_ids},
).json()
for run_id, run_result in srt_bulk.items():
    if "transcript" in run_result:
        print(f"Run {run_id}: {run_result['transcript']}")
    else:
        for language_id, payload in run_result.items():
            print(f"Run {run_id} / lang {language_id}: {payload['transcript']}")

Best Practices

Batch size: at least 2 and at most 5 run_id values per request
Larger sets: split into chunks of 3–5 and process sequentially to avoid rate limits

Next Steps

Get Subtitle Result for a single run (same export params)
Get Subtitle Result for Language when you only need one language
Create Subtitle to start a new run

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.

Query Parameters

format_type

enum<string> | null

default:txt

Subtitle format for the transcript export: srt, vtt or txt. When omitted (and data_type is also omitted) the structured JSON transcript is returned instead of an exported file. Applied to every language on each run.

Available options:

srt,

vtt,

txt

data_type

enum<string> | null

default:file

How the exported transcript is returned once format_type/data_type is set: file returns a presigned URL, raw_data returns the raw text. In export mode the effective defaults are format_type=txt, data_type=file. Applied to every language on each run.

Available options:

raw_data,

file

Body

application/json

run_ids

integer[]

required

An array of unique positive integers, each representing the ID of a specific run. You must provide between 2 and 5 IDs, and all IDs must correspond to the same run type (e.g., all text-to-speech or all dubbing runs).

Required array length: 2 - 5 elements

Example:

[12345, 6789]

Response

Successful Response

An object containing the results of one to five subtitle runs. Each key is a run ID; each value matches GET /sub-result/{run_id} (JSON by default, or export when format_type/data_type are set).

{key}

Single Language · object

One language of a subtitle run: structured dialogue segments by default, or an exported transcript string when format_type/data_type are set.

Single Language
Multiple Languages

Hide child attributes

{key}.transcript

Structured dialogue array by default; a string (presigned URL for data_type=file, or raw text for data_type=raw_data) in export mode.

Hide child attributes

{key}.transcript.start

number<float>

required

The start time (in seconds) of the dialogue.

{key}.transcript.end

number<float>

required

The end time (in seconds) of the dialogue.

{key}.transcript.text

string

required

The actual text content of the dialogue spoken by the speaker.

{key}.transcript.speaker

string

required

The name or identifier of the speaker delivering the dialogue.

Last modified on July 26, 2026

End to End DubbingInitiate a full end to end dubbing task.

Get Subtitle Results

curl --request POST \
  --url https://client.camb.ai/apis/sub-results \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "run_ids": [
    12345,
    6789
  ]
}
'

import requests

url = "https://client.camb.ai/apis/sub-results"

payload = { "run_ids": [12345, 6789] }
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_ids: [12345, 6789]})
};

fetch('https://client.camb.ai/apis/sub-results', 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/sub-results",
  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_ids' => [
        12345,
        6789
    ]
  ]),
  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;
}

{}

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

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Fetch Subtitle Results

Choosing your output

Request

Response Structure

Default (no export params)

Export (`format_type` / `data_type`)

Implementation Example

Best Practices

Next Steps

Authorizations

Query Parameters

Body

Response

​Choosing your output

​Request

​Response Structure

​Default (no export params)

​Export (format_type / data_type)

​Implementation Example

​Best Practices

​Next Steps

Authorizations

Query Parameters

Body

Response

Choosing your output

Request

Response Structure

Default (no export params)

Export (`format_type` / `data_type`)

Implementation Example

Best Practices

Next Steps