Text

Translation

Translate text across 342 source-target directions with Perigee-1-text.

Perigee-1-text translates between 19 supported languages. Your application makes one request; routing is handled automatically.

Translate Hausa to Yoruba

import os
import orbitalsai
 
client = orbitalsai.Client(api_key=os.environ["ORBITALSAI_API_KEY"])
 
translation = client.translate(
    text="Sannu da zuwa",
    source_language="Hausa",
    target_language="Yoruba",
)
 
print(translation.text)
Káàbọ̀

REST request

curl -X POST "https://api.orbitalsai.com/api/v1/text/translate" \
  -H "Authorization: Bearer $ORBITALSAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Sannu da zuwa",
    "source_language": "Hausa",
    "target_language": "Yoruba",
    "stream": false
  }'
FieldRequiredDescription
textYesText to translate.
source_languageYesLanguage of the input. See Language support.
target_languageYesOutput language; it must differ from the source.
domainNoVocabulary context such as banking, healthcare, or general conversation.
streamNoReturn server-sent events when true.

Response

{
  "status": "complete",
  "result": "Káàbọ̀",
  "model_name": "Perigee-1-text",
  "processing_time": 1.24,
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 4,
    "total_tokens": 22,
    "calls": 1,
    "cost": 0.00011
  }
}

Responses also contain a job_id, processing metadata, and a route value. Treat the route as diagnostic metadata; do not design application behavior around an internal translation path.

Longer input

Use an async text job when the request should not hold an HTTP connection open.

Next steps

On this page