Translate text to any of 100+ supported languages using neural machine translation.
POST /translate/v1/translate
import Casedev from 'casedev';
const client = new Casedev({ apiKey: 'sk_case_YOUR_API_KEY' });
const result = await client.translate.v1.translate({
q: 'The plaintiff filed a motion for summary judgment.',
target: 'es'
});
console.log(result.data.translations[0].translatedText);
// "El demandante presentó una moción de juicio sumario."
{
"data": {
"translations": [
{
"translatedText": "El demandante presentó una moción de juicio sumario.",
"detectedSourceLanguage": "en"
}
]
}
}
Parameters
Required
| Parameter | Type | Description |
|---|
q | string or string[] | Text to translate. Can be a single string or array for batch translation. |
target | string | Target language code (ISO 639-1), e.g., es, fr, de, zh |
Optional
| Parameter | Type | Default | Description |
|---|
source | string | auto-detect | Source language code. If omitted, language is automatically detected. |
format | string | text | Format of source text: text or html |
model | string | nmt | Translation model: nmt (neural) or base |
Batch translation
Translate multiple strings in a single request:
const result = await client.translate.v1.translate({
q: [
'Hello',
'Goodbye',
'Thank you',
'Please sign here'
],
target: 'fr',
source: 'en'
});
result.data.translations.forEach((t, i) => {
console.log(t.translatedText);
});
// "Bonjour"
// "Au revoir"
// "Merci"
// "Veuillez signer ici"
HTML preservation
Preserve HTML tags during translation with format: 'html':
const result = await client.translate.v1.translate({
q: '<p>The <strong>defendant</strong> denies all allegations.</p>',
target: 'de',
format: 'html'
});
console.log(result.data.translations[0].translatedText);
// "<p>Der <strong>Beklagte</strong> bestreitet alle Anschuldigungen.</p>"
Common language codes
| Language | Code |
|---|
| English | en |
| Spanish | es |
| French | fr |
| German | de |
| Chinese (Simplified) | zh |
| Chinese (Traditional) | zh-TW |
| Japanese | ja |
| Korean | ko |
| Arabic | ar |
| Portuguese | pt |
| Russian | ru |
| Italian | it |
Examples
Translate a legal document
const document = `
NOTICE OF MOTION
PLEASE TAKE NOTICE that the undersigned will move this Court
at the Courthouse located at 100 Centre Street, New York, NY
on the 15th day of January, 2025, at 9:30 a.m., for an order...
`;
const result = await client.translate.v1.translate({
q: document,
target: 'es'
});
Auto-detect source language
// Source language is detected automatically
const result = await client.translate.v1.translate({
q: 'Bonjour, comment puis-je vous aider?',
target: 'en'
});
console.log(result.data.translations[0].detectedSourceLanguage); // "fr"
console.log(result.data.translations[0].translatedText); // "Hello, how can I help you?"
Pricing: $0.05 per 1,000 characters. A 50,000 character document costs $2.50.