Skip to main content

Documentation: Autolanguage plugin

DeepL API Key

Deepl is only available in the PRO version.
Unlock this and other features by upgrading to Joomill Autolanguage PRO

Go PRO

Getting a DeepL API key is a straightforward process. However, it is important to distinguish between the DeepL API (for software/code integration) and the DeepL Pro subscription (for manual translation via the website or app).

Step 1: Choose the Right Plan

First, determine which version suits your needs. Note that even the Free tier requires a payment method for identity verification.

Feature DeepL API Free DeepL API Pro
Cost Free (€0/month) €4.99/month + usage costs
Limit Max. 500,000 characters/month Unlimited (pay-per-character)
Data Privacy Texts may be used to train models. Maximum security: Texts are never stored.
Best For Hobby projects, testing, low-traffic sites. Businesses, confidential data, high volumes.

Step 2: Create Your Account

  1. Visit the official DeepL API page: https://www.deepl.com/

  2. You will see two columns: DeepL API Free and DeepL API Pro.

  3. Click "Sign up for free" (for the Free tier) or "Buy now" (for the Pro tier).

Step 3: Registration and Verification

This is the stage where most users encounter issues. Please follow closely:

  1. Account Setup: Enter your email address and create a password (or log in if you already have a standard account).

  2. Contact Information: Fill in your name and address details.

  3. Identity Verification (Crucial):

    • Credit Card Requirement: Even for the Free API, DeepL requires a valid credit card (Visa, Mastercard, Amex, etc.).

    • Why? This prevents bot abuse and multiple account creation. You will not be charged on the Free plan unless you manually upgrade.

    • No Credit Card? Currently, it is nearly impossible to obtain a key without a credit card or a bank account that supports SEPA direct debit (available only in specific regions).

Step 4: Locate Your API Key

Once your registration is complete, your key is generated immediately.

  1. Ensure you are logged in at deepl.com.

  2. Click on your profile icon/name in the top-right corner and select Account.
    deepl api 01

  3. In the top menu click on API keys & limits
    deepl api 02

  4. Click on the blue button "Create Key".
    deepl api 03

  5. Give your Key a name and Save

  6. You will see a long string of characters (e.g., f63c02c5-....:fx). Copy this key.
    Tip: If your key ends with :fx, it confirms you are on the Free tier. Pro keys do not have this suffix.

Step 5: Integration in Joomla

  1. Log in to your Joomla Backend.

  2. Navigate to Plugins > System - Autolanguage.

  3. Open the Service & API tab.

  4. Select Deepl API 

  5. Paste your key into the Deepl API Key field.
    deepl api 04

  6. Save.

  7. After you have save the API key, you can see the API Usage and Status in the plugin
    deepl api 05