<aside>

Description

Custom Translation Engines allow you to integrate any translation service provider that offers an API. This guide covers engine creation, authentication configuration, and response structure mapping.

</aside>

How to Create a Custom Translate Engine in SimpleT

  1. Navigate to Translation Engine in the NavBar
  2. Click New Engine
  3. Select Custom Translate Engine as the Translation Engine
  4. Enter the URL of your translation API endpoint
  5. Select the Method: GET, POST, or PUT
  6. Select the Authentication Protocol (see options below)
  7. Select the Desired Structure matching your API's response format (see below)
  8. Fill in the credentials required for your chosen authentication method
  9. Select the Languages this engine should support
  10. Set the Batch Size and Priority
  11. Click Create

Authentication Options

Method Required Fields
No Auth None — URL only
Bearer Token Token Prefix (e.g. "Bearer") + Bearer Token value
Basic Authentication Username + Password
OAuth 2.0 Client ID + Client Secret + Callback URL + Scope

Desired Structure

The Desired Structure tells SimpleT how to read the response from your API. Your API must return a response that matches one of the following formats:

Structure Expected Response Format
google-translate { "data": { "translations": [{ "translatedText": "..." }] } }
deepl { "translations": [{ "text": "..." }] }
chat-gpt { "choices": [{ "message": { "content": "..." } }] }
aws Uses AWS SDK directly — no URL needed

Common Errors

Error Cause
Unable to obtain authentication headers Auth fields are empty or incorrect
Access Denied (403) Wrong API key or token
API response is not valid JSON API returned HTML or an error page instead of JSON
Response format is invalid Desired Structure does not match your API's actual response
No data provided for translation No source language strings found

custom-translation-engine.png

<aside>

Quick View

End User Documentation