Customizing Your Translation
Language Selection
For successful translation, youβll need to specify both source and target languages:- Source Language: The original language of your text
- Target Language: The language you want your text translated into
- Check the
/source-languages
or/target-languages
endpoints for a complete list of supported languages with their corresponding IDs.
Style and Tone Customization
Our platform offers several ways to tailor translations to your specific audience:-
Formality: Adjust the formality level to match your context:
- Formal (1): Professional communications, official documents
- Informal (2): Casual conversations, social media content
- Gender: Specify grammatical gender preferences when relevant in the target language
- Age: Adjust vocabulary and expressions to be age-appropriate for your intended audience
Domain Expertise
For specialized content, you can enhance accuracy with domain-specific terminology:- Chosen Dictionaries: Include specialized vocabulary dictionaries to ensure technical terms are translated appropriately for fields like medicine, law, technology, or other industries
How the Process Works
This endpoint uses an asynchronous workflow, allowing your application to continue operations while translation processing happens in the background:Submit Your Request
Receive Your `task_id`
task_id
. This identifier lets you check on your translationβs progress at any time.Track Progress of Your Translation
task_id
to monitor the current status of your request by calling the /translate/{task_id}
endpoint. This will tell you whether your translation is still in progress, completed, or if any issues occurred.Example: Creating Your First Translation
Hereβs a practical example showing how to translate business communications from English to Spanish:Authorizations
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.
Body
The original language of your text. This field is required and must contain a valid language ID.
1
, 2
, 3
, 4
, 5
, 6
, 7
, 8
, 9
, 10
, 11
, 12
, 13
, 14
, 15
, 16
, 17
, 18
, 19
, 20
, 21
, 22
, 23
, 24
, 25
, 26
, 27
, 28
, 29
, 30
, 31
, 32
, 33
, 34
, 35
, 36
, 37
, 38
, 39
, 40
, 41
, 42
, 43
, 44
, 45
, 46
, 47
, 48
, 49
, 50
, 51
, 52
, 53
, 54
, 55
, 56
, 57
, 58
, 59
, 60
, 61
, 62
, 63
, 64
, 65
, 66
, 67
, 68
, 69
, 70
, 71
, 73
, 74
, 75
, 76
, 78
, 79
, 80
, 81
, 82
, 83
, 84
, 85
, 86
, 87
, 88
, 90
, 91
, 92
, 93
, 94
, 95
, 96
, 97
, 98
, 99
, 100
, 101
, 102
, 103
, 104
, 106
, 107
, 108
, 109
, 110
, 111
, 112
, 113
, 114
, 115
, 116
, 117
, 118
, 119
, 120
, 121
, 122
, 123
, 124
, 125
, 126
, 127
, 128
, 129
, 130
, 131
, 132
, 133
, 134
, 135
, 136
, 139
, 140
, 141
, 142
, 143
, 144
, 145
, 146
, 148
The language you want your text translated into. This field is required and must contain a valid language ID.
1
, 2
, 3
, 4
, 5
, 6
, 7
, 8
, 9
, 10
, 11
, 12
, 13
, 14
, 15
, 16
, 17
, 18
, 19
, 20
, 21
, 22
, 23
, 24
, 25
, 26
, 27
, 28
, 29
, 30
, 31
, 32
, 33
, 34
, 35
, 36
, 37
, 38
, 39
, 40
, 41
, 42
, 43
, 44
, 45
, 46
, 47
, 48
, 49
, 50
, 51
, 52
, 53
, 54
, 55
, 56
, 57
, 58
, 59
, 60
, 61
, 62
, 63
, 64
, 65
, 66
, 67
, 68
, 69
, 70
, 71
, 72
, 73
, 74
, 75
, 76
, 77
, 78
, 79
, 80
, 81
, 82
, 83
, 84
, 85
, 86
, 87
, 88
, 89
, 90
, 91
, 92
, 93
, 94
, 95
, 96
, 97
, 98
, 99
, 100
, 101
, 102
, 103
, 104
, 105
, 106
, 107
, 108
, 109
, 110
, 111
, 112
, 113
, 114
, 115
, 116
, 117
, 118
, 119
, 120
, 121
, 122
, 123
, 124
, 125
, 126
, 127
, 128
, 129
, 130
, 131
, 132
, 133
, 134
, 135
, 136
, 139
, 140
, 141
, 142
, 143
, 144
, 145
, 146
, 147
, 148
, 149
, 150
An array of strings to be translated. This field is required and can contain multiple text segments for batch translation.
An integer representing the intended audience age. This helps adjust vocabulary and expressions to be age-appropriate, which is particularly important when translating content for children, teenagers, or specific age demographics.
Specifies whether the translated text should be formal or informal. This affects the tone and word choices in languages.
1
, 2
Specifies grammatical gender preferences when relevant in the target language. In many languages, adjectives, nouns, and verbs may change form based on gender, and this parameter helps ensure the translation uses the appropriate forms.
0
, 1
, 2
, 9
An optional parameter that allows you to specify specialized vocabulary dictionaries to use during translation. This ensures that technical terms are translated appropriately for specific fields like medicine, law, technology, or other industries.
1
Enter a distinctive name for your project that reflects its purpose or content. This name will be displayed in your CAMB.AI workspace dashboard and used to organize related assets, transcriptions, etc.. . Choose something memorable that helps you quickly identify this specific project among your other voice, audio and localization tasks.
3 - 255
Provide details about your project's goals and specifications. Include information such as the target languages for translation or dubbing, desired voice characteristics, emotional tones to capture, or specific audio processing requirements, outlining the workflow here can serve as valuable documentation for organizational purposes.
3 - 5000
Specify the organizational folder within your CAMB.AI workspace where this task should be created and stored. The folder must already exist in your workspace and be accessible through your current API key authentication. This helps maintain project organization by grouping related tasks together, making it easier to manage and locate your projects.
x >= 1
Response
Successful Response
A JSON that contains unique identifier for the task. This is used to query the status of the translation task that is running. It is returned when a create request is made for translation.