---
canonical_url: "https://docs.composio.dev/toolkits/camb_ai"
markdown_url: "https://docs.composio.dev/toolkits/camb_ai.md"
product: "platform"
version: null
last_updated: null
---

# CAMB.AI

CAMB.AI provides hosted APIs for multilingual dubbing, speech synthesis, transcription, translation, voice cloning, and audio generation.

- **Category:** audio & speech
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `CAMB_AI`
- **Version:** 20261014_00

## Tools

### Dub Media

**Slug:** `CAMB_AI_DUB_MEDIA`

Dub media from a URL into one or more target languages, wait for completion, and return the output video, audio, and structured transcript.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_url` | string | Yes | Public or signed URL of the audio or video media to dub. |
| `source_language` | string | Yes | Locale tag for the spoken source language, such as en-us. |
| `timeout_seconds` | number | No | Maximum wall-clock seconds to wait for completion (10-900). This is not sent to CAMB.AI. |
| `target_languages` | array | Yes | One or more target locale tags for dubbed outputs. |
| `transcription_mode` | string ("fast" | "slow") | No | fast is quicker; slow may improve transcription accuracy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Subtitles

**Slug:** `CAMB_AI_GENERATE_SUBTITLES`

Generate translated subtitles for media in one or more languages, wait for CAMB.AI to finish, and return structured subtitle cues.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | integer | No | Optional positive workspace folder ID for the subtitle run. |
| `media_url` | string | Yes | Public or signed URL of the source audio or video. |
| `source_language` | string | Yes | Locale tag for the spoken source language, such as en-us. |
| `timeout_seconds` | number | No | Maximum wall-clock seconds to wait for completion (10-900). This is not sent to CAMB.AI. |
| `target_languages` | array | Yes | One or more locale tags for subtitle output. |
| `formatting_options` | object | No | Optional subtitle segmentation settings applied to every target language. |
| `transcription_mode` | string ("fast" | "slow") | No | fast is quicker; slow may improve transcription accuracy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Run Result

**Slug:** `CAMB_AI_GET_RUN_RESULT`

Fetch the structured JSON result for a successful CAMB.AI translation, transcription, dubbing, or subtitle run when its run ID is known.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | integer | Yes | Positive run ID returned when the task reached SUCCESS. |
| `workflow` | string ("translation" | "transcription" | "dubbing" | "subtitles") | Yes | Run family that produced the run ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Task Status

**Slug:** `CAMB_AI_GET_TASK_STATUS`

Check one CAMB.AI translation, transcription, dubbing, or subtitle task without waiting. Use this to recover a task after a workflow timeout or when a task ID is already known.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | Yes | Task ID returned by the corresponding creation workflow. |
| `workflow` | string ("translation" | "transcription" | "dubbing" | "subtitles") | Yes | Task family that created the task ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Supported Languages

**Slug:** `CAMB_AI_LIST_LANGUAGES`

List CAMB.AI source and target languages, including locale tags and numeric IDs used by generation tools.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Voices

**Slug:** `CAMB_AI_LIST_VOICES`

Find CAMB.AI voices by name, description, language ID, gender, or publication state before choosing a voice for speech workflows.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum matching voices to return after local filtering (1-100). |
| `gender` | integer | No | Provider gender code to match exactly when known. |
| `search` | string | No | Case-insensitive text to match in voice_name, description, or tags. |
| `language_id` | integer | No | Numeric language ID to match; obtain IDs from CAMB_AI_LIST_LANGUAGES. |
| `published_only` | boolean | No | When true, return only voices marked is_published. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Transcribe Media

**Slug:** `CAMB_AI_TRANSCRIBE_MEDIA`

Transcribe an uploaded audio/video file or a media URL, wait for CAMB.AI to finish, and return a structured speaker-and-timing transcript.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | Yes | Spoken source locale tag, such as en-us. |
| `media_url` | string | No | Public or signed audio/video URL; provide this or media_file, not both. |
| `media_file` | object | No | A file the caller hands IN. ``s3key`` is an S3/R2 reference (production) or a base64 ``data:`` URL (self-hosted ``FILE_BACKEND=base64``) — the ``FileStore`` knows which. Mirrors ``mercury/tools/files.py`` field-for-field. |
| `timeout_seconds` | number | No | Maximum wall-clock seconds to wait for completion (10-900); not sent to CAMB.AI. |
| `formatting_options` | object | No | Optional transcript segmentation settings. Set maximum and minimum segment duration in seconds or maximum characters per segment. |
| `transcription_mode` | string ("fast" | "slow") | No | fast is quicker; slow may improve transcription accuracy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Translate Text

**Slug:** `CAMB_AI_TRANSLATE_TEXT`

Translate one or more text segments and wait for CAMB.AI to return all translated segments in input order.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `age` | integer | No | Intended audience age used to adapt the translated vocabulary. |
| `texts` | array | Yes | Non-empty text segments to translate; translated segments preserve this order. |
| `gender` | integer ("0" | "1" | "2" | "9") | No | CAMB.AI gender code for grammatical-gender preference: 0, 1, 2, or 9. |
| `formality` | string ("formal" | "informal") | No | Tone preference for the translation: formal or informal. |
| `source_language` | string | Yes | Source locale tag from CAMB_AI_LIST_LANGUAGES. |
| `target_language` | string | Yes | Target locale tag from CAMB_AI_LIST_LANGUAGES. |
| `timeout_seconds` | number | No | Maximum wall-clock seconds to wait for completion (10-900). Not sent to CAMB.AI. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |