;
## Overview
Translate text and generate speech in one API call. Input text in any language, get audio output in your target language.
This is different from the standard TTS API which only changes accents. Translated TTS actually **translates** your text before speaking.
### Hear the Translations
Same English input, automatically translated and spoken in each language:
### Prerequisites
Sign up at [CAMB.AI Studio](https://studio.camb.ai) if you haven't already.
Go to **Settings → API Keys** in Studio and copy your key. See [Authentication](/getting-started/authentication) for details.
```bash Python theme={null}
pip install camb-sdk
```
```bash TypeScript theme={null}
npm install @camb-ai/sdk
```
Skip this step if you're using the [direct API](/tutorials/direct-api).
```bash theme={null}
export CAMB_API_KEY="your_api_key_here"
```
***
## Code
```python Python theme={null}
import os
import time
import requests
from camb.client import CambAI
from camb.types.language_enums import Languages
client = CambAI(api_key=os.getenv("CAMB_API_KEY"))
def translate_and_speak():
# Translate English to Spanish and generate speech
# Language codes: 1 = English (US), 54 = Spanish (Spain)
response = client.translated_tts.create_translated_tts(
text="Hello, welcome to our service. We're glad to have you here.",
source_language=Languages.EN_US, # English (US)
target_language=Languages.ES_ES, # Spanish (Spain)
voice_id=144300 # Voice ID (required)
)
task_id = response.task_id
print(f"Task created: {task_id}")
# Poll for completion
while True:
status = client.translated_tts.get_translated_tts_task_status(task_id=task_id)
print(f"Status: {status.status}")
if status.status == "SUCCESS":
# Get the audio URL and download
result = client.text_to_speech.get_tts_run_info(
run_id=status.run_id,
output_type="file_url"
)
audio_response = requests.get(result.output_url)
with open("translated_output.wav", "wb") as f:
f.write(audio_response.content)
print("Saved to translated_output.wav")
break
elif status.status == "FAILED":
print("Translation failed!")
break
time.sleep(2)
translate_and_speak()
```
```javascript TypeScript theme={null}
import { CambClient } from '@camb-ai/sdk';
import fs from 'fs';
const client = new CambClient({
apiKey: process.env.CAMB_API_KEY
});
async function translateAndSpeak() {
// Translate English to Spanish and generate speech
// Language codes: 1 = English (US), 54 = Spanish (Spain)
console.log('Translating and generating speech...');
const response = await client.translatedTts.createTranslatedTts({
text: "Hello, welcome to our service. We're glad to have you here.",
source_language: 1, // English (US)
target_language: 54, // Spanish (Spain)
voice_id: 144300 // Voice ID (required)
});
const taskId = response.task_id;
console.log(`Task created: ${taskId}`);
// Poll for completion
while (true) {
const status = await client.translatedTts.getTranslatedTtsTaskStatus({
task_id: taskId
});
console.log(`Status: ${status.status}`);
if (status.status === 'SUCCESS') {
// Small delay to ensure result is available in backend
await new Promise(r => setTimeout(r, 1000));
// Get the audio URL and download
const result = await client.textToSpeech.getTtsRunInfo({
run_id: status.run_id,
output_type: 'file_url'
});
const audioResponse = await fetch(result.output_url);
const buffer = Buffer.from(await audioResponse.arrayBuffer());
fs.writeFileSync('translated_output.wav', buffer);
console.log('Saved to translated_output.wav');
break;
} else if (status.status === 'FAILED') {
console.log('Translation failed!');
break;
}
await new Promise(r => setTimeout(r, 2000));
}
}
translateAndSpeak();
```
***
## Parameters
| Parameter | Description |
| ----------------- | ------------------------------------------------------- |
| `text` | Input text to translate |
| `source_language` | Numeric language ID of input (e.g., `1` for English) |
| `target_language` | Numeric language ID for output (e.g., `54` for Spanish) |
| `voice_id` | Voice ID to use for speech generation (required) |
### Common Language IDs
| Language | ID |
| ------------------- | ----- |
| English (US) | `1` |
| Spanish (Spain) | `54` |
| French (France) | `76` |
| German (Germany) | `31` |
| Japanese (Japan) | `88` |
| Hindi (India) | `81` |
| Portuguese (Brazil) | `111` |
| Chinese (Mandarin) | `139` |
***
## Use Cases
***
## Next Steps
Add emotional expression to translated speech.
Speak in 140+ accents without translating.
Generate speech from text using the SDK.
Clone a voice from reference audio.
Full Translated TTS API specification.