Quickstart
Get an API key and translate your first sentences, with a quality score for each one.
The TranslaQE API translates text and documents and tells you, sentence by sentence, how much to trust each translation. This page takes you from nothing to a first translation.
1. Get an API key
Create a free account and open API keys in the web app. Create a key and copy it: it is shown only once. The free trial gives you a month and 100,000 characters, with no card.
Keep the key on your server. Do not put it in a web page or in an app that people download.
export TRANSLAQE_API_KEY="tq_live_…"
2. Translate
Send the sentences to POST /v1/translate, with the language they are in and the language you want.
curl https://api.translaqe.com/v1/translate \
-H "Authorization: Bearer $TRANSLAQE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"source_lang": "es",
"target_lang": "en",
"segments": [
"El contrato entra en vigor el 1 de marzo.",
"Las partes podrán rescindirlo con un preaviso de 30 días."
]
}'3. Read the answer
Each sentence comes back with its translation, a score from 0 to 100 and a band:
{
"source_lang": "es",
"target_lang": "en",
"segments": [
{
"index": 0,
"source": "El contrato entra en vigor el 1 de marzo.",
"target": "The agreement enters into force on 1 March.",
"score": 93,
"band": "fiable",
"status": "translated",
"applied_terms": [],
"checks": []
},
{
"index": 1,
"source": "Las partes podrán rescindirlo con un preaviso de 30 días.",
"target": "The parties may terminate it with 30 days' notice.",
"score": 71,
"band": "revisar",
"status": "translated",
"applied_terms": [],
"checks": []
}
]
}
| Band | Score | What to do |
|---|---|---|
fiable |
85 or more | Reliable: use it as it is. |
revisar |
60 to 84 | Worth a review by a person. |
rehacer |
Under 60 | Translate it again. |
sin-nota |
— | No score: the language pair has none yet, or you sent qe: false. |
That is the point of the score: send to human review only the sentences that need it.
Where to go next
- Authentication: keys, limits and request ids.
- Translate text: post-editing, memories, glossaries and style instructions.
- Translate documents: DOCX, XLSX, PPTX, HTML and more, keeping their layout.
- Memories and glossaries: make the engine translate your way.
- Errors and limits: what each error means and when to retry.
- API reference: every route, field by field. The same contract is published as OpenAPI 3.1.