DeepL
AI Authentication keyTranslate text and documents with DeepL from any Windmill script, flow or app.
Set up in 3 steps
Copy your authentication key
In your DeepL account, open the API keys page and copy the key. A Free key ends in :fx.
Add the resource in Windmill
Open Resources, add a resource of type deepl. baseUrl must match your plan — https://api-free.deepl.com for Free, https://api.deepl.com for Pro.
Run your first script
Fork any script below and read before writing anything.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
Upload and Translate a Document
Retrieve Supported Languages
Retrieve Glossary Entries
Retrieve Glossary Details
Request Translation
List all Glossaries
List Language Pairs Supported by Glossaries
Download Translated Document
Delete a Glossary
Create a Glossary
Check Usage and Limits
Check Document Status
Resource type
deepl — the shape of the credential every script on this page expects.
| Field | Type | Required | What it is |
|---|---|---|---|
| apiKey | string | Yes | API key generated on the dashboard for DeepL API product. |
| baseUrl | string | Yes | Base URL for your API plan - free and pro have different API base URLs. |
Questions
Which baseUrl do I need?
The one matching your plan. A Free key on the Pro host is rejected as unauthorized, which looks like a bad key rather than a wrong host.
Translation is metered
DeepL counts characters against your plan. Document translation counts the whole document, not just what changed.
Is my key stored on the hub?
Never. It lives only in your own Windmill workspace, encrypted at rest.