Translate Text

About Translate Text

The Translate Text service works in a context-based processing, providing quick and precise translations for text.

Supported Languages

The output_language parameter allows to select the language for the translation, and it uses ISO 639 langugage codes. Here you can find some of the codes for some languages.

It is also allowed to specify the region (according to ISO 39 codes), for example for French it may be fr-FR, fr-BE, fr-CA, for English en-GB or en-US, or for Spanish es-ES, es-MX ...

Refer to the ISO 639-1 codes for more options.

Step-by-step Tutorial

In this guide:

• Section 1: Prerequisites.
• Section 2: Setup Cosmos Python Client.
• Section 3: Translate text.
• Section 4: Handle Errors.

1. Prerequisites

Before you begin, ensure you have:

• An active CosmosPlatform account
• API key from the API keys dashboard

2. Setup Cosmos Python Client

Using Python Cosmos client you can perform the API requests in a convenient way.

2.1. Install Cosmos Python Client:

Get the Cosmos Python client through PIP:

pip install delos-cosmos

2.2. Authenticate Requests:

Initialize the client with your API key:

from cosmos import CosmosClient

cosmos_client = CosmosClient(api_key=your-cosmos-api-key)

2.3. Call API:

You can start invoking any Cosmos endpoints. For example, let's try the /health endpoint to check the validity of your API key and the availability of the client services:

response = cosmos_client.status_health()
print(response)

3. Translate text

Initialize the client and perform your request (/translate_text endpoint):

from cosmos import CosmosClient

cosmos_client = CosmosClient(api_key="your-cosmos-api-key")
response = cosmos_client.translate_text(
              text="Hello, how are you?",
              output_language="es"
            )
print(response)

If your request is successful, you will receive a response containing the translated text. Example:

{
  "request_id": "f9c3e66-0a8b-4b62-a292-2c9371b3f020",
  "status_code": 200,
  "translation": "Hola, ¿cómo estás?"
}

3.1. Parameters:

The parameters for the text translation request are:

4. Handle Errors

• If there’s an error, you’ll receive a response with details. For example, if the text is missing:

{
  "status_code": 400,
  "error_message": "No text provided for translation."
}