Accessing the DeepL Free and Pro APIs from Loco
You will need a DeepL API subscription in order to access v2 of their API. Be sure to subscribe to the correct plan.
Configure a bot to use DeepL
- Navigate to the Bots tab wherever you see the :robot icon: in the Loco dashboard.
- Click "New bot", choose DeepL, and enter your DeepL API key into the only text field.
- Save the bot and it's ready to run. See also how to run a translation bot.
Steps for generating a DeepL API key
- Get a DeepL account and subscribe to any API plan.
- Go to your DeepL account settings and copy the Authentication Key to your clipboard.
API versions and DeepL plans
Loco supports v2 of the DeepL API only. You must be subscribed to DeepL API Free or DeepL API Pro to use this version of the API.
We recommend you start with their free plan, and upgrade to a paid plan if your usage requires it.
Other DeepL plans use the v1 API. Loco has no support for the older API. It is not publicly documented and DeepL require special permission to integrate with it.
If you have any questions about DeepL plans and how they relate to API access, please ask DeepL support.
Supported languages
See the DeepL documentation for the languages currently supported by the v2 API.
Loco tries to map your project locales to these values. For example fr-CA will be sent as just FR, and zh-Hant as just ZH.
You may find that regional variations are not supported, or don't behave quite as expected. For this reason, you may want to consider using a glossary to account for differences.
Loco doesn't currently support formality variance. This is planned for development.
Glossary support
You can use DeepL glossaries by nominating a Loco project as the source of language pairs. This is for Loco Pro accounts only. Bots with a glossary enabled can still be run from free accounts, but the glossary function will be disabled.
To configure DeepL to use a glossary from Loco: create a new bot, or open its settings from the :cog icon:. Then select a Loco project from the dropdown list. If you don't see this option, either you have a free account, or there are no projects available.
Any Loco project can be used as a glossary, but only language pairs supported by DeepL can be used, and only within the size restrictions; e.g. 1024 bytes maximum per term. Please read DeepL's documentation.
Every time you run your DeepL bot, Loco will sync the required language pairs to a DeepL glossary. It will adopt a name like "Loco 1234 en-de".
The corresponding DeepL glossary_id will change every time your project updates, so using these IDs outside Loco is not recommended.
If you have existing DeepL glossaries, you can import them into Loco as tab-separated, or comma-separated files. See Importing glossary pairs. Likewise you can export your Loco glossary projects to suitable dictionary files and use them elsewhere. See Exporting glossary pairs.