Translation

Translate a transcript into another language, list supported languages, and manage existing translations.

Translate a transcript into another language and manage the translations linked to it. Each translation is created as a new file that is linked back to the original transcript, so it can be retrieved or processed like any other Trint file. Authenticate with Basic Authentication using your API key ID and secret.

Language codes

The targetLanguage must be a supported language code (for example fr for French). Call the Translation Languages endpoint to retrieve the full list of supported languages and their codes before requesting a translation.

Supported translation languages

Retrieves a list of supported languages for translation. Each language includes a human-readable name and its corresponding language code, which can be used when specifying translation targets.

Translation Languages

gethttps://translation.api.trint.com/translation-languages

Retrieves a list of supported languages for translation. Each language includes a human-readable name and its corresponding language code, which can be used when specifying translation targets.

GET /translation-languages

curl --request GET \  --url 'https://translation.api.trint.com/translation-languages' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

Response 200

200 response

{
    "data": {
        "translationLanguages": [
            {
                "languageName": "Afrikaans",
                "languageCode": "af"
            },
            {
                "languageName": "Albanian",
                "languageCode": "sq"
            },
            {
                "languageName": "Amharic",
                "languageCode": "am"
            },
            {
                "languageName": "Arabic",
                "languageCode": "ar"
            },
            {
                "languageName": "Armenian",
                "languageCode": "hy"
            },
            {
                "languageName": "Azerbaijani",
                "languageCode": "az"
            },
            {
                "languageName": "Bengali",
                "languageCode": "bn"
            },
          	...
          ],
          
    },
}

200200

400400

Create a translation

Creates a translation of a file. Provide the targetLanguage as a supported language code. Once the translation is complete, the translated file is linked to the original file and available for retrieval or further processing.

Create Translation

posthttps://translation.api.trint.com/

This endpoint creates a translation of a file. The targetLanguage should be provided using a supported language code. Once the translation is complete, the translated file will be linked to the original file and available for retrieval or further processing.

Body parameters

transcriptIdstringoptional

trint-id to translate

targetLanguagestringoptional

language code to translate into

POST /

curl --request POST \  --url 'https://translation.api.trint.com/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{}'

Response 200

200 response

{
  "data": {
    "fileId": "example9KD-8Eo7Casfake",
    "createdDate": 1000222100000,
    "languageCode": "es",
    "sourceFileId": "exampleCR7e5gFx-Y7fake"
  }
}

200200

400400

Retrieve existing translations

Retrieves the translation references for a transcript (trint-id), including the source file and any translations linked to it.

Get Translations

gethttps://translation.api.trint.com/

Retrieves translation references for a fileId (trint-id). Source and Translations.

Body parameters

transcriptIdstringoptional

trint-id

GET /

curl --request GET \  --url 'https://translation.api.trint.com/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{}'

Response 200

200 response

{
  "data":
    {
      "source":
        {
          "fileId": "exampleCR7e5gFx-Y7fake",
          "languageCode": "en",
          "languageName": "English",
          "createdDate": 1000157600000,
        },
      "translations":
        [
          {
            "fileId": "exampleHTfi4YuvgI0fake",
            "languageCode": "fr",
            "languageName": "French",
            "createdDate": 1000222100000,
          }
        ],
    },
}

200200

400400

Delete a translation

Deletes an existing translation.

Delete Translation

deletehttps://translation.api.trint.com/

Deletes an existing translation.

Body parameters

transcriptIdstringoptional

trint-id to delete

DELETE /

curl --request DELETE \  --url 'https://translation.api.trint.com/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{}'

Response 200

200 response

{
  "data": {
    "fileId": "exampleSRQGSZjBcvfake",
    "deleted": true
  }
}

200200

400400