Get access to your DeepL API key now: log into your account and open the API section to generate it in a few clicks.
If you want to speed things up, simply start using the key in your apps and monitor results in real-time.
This shows how to connect your blog e il tuo website to DeepL translations with in tempo reale results across websites you manage.
Choose a plan, copy your key, and store it securely. This lets you wire DeepL translations into automatizzato apps e il tuo website or blog editor for in tempo reale aggiornamenti.
To integrate, place the key in your app settings or environment variables, and point your code to the DeepL API endpoint. This yields consistent translations with results across pages and posts, so readers see up-to-date content on websites you publish.
Real-world tip: generate a separate account key for each project, rotate keys every 90 days, and restrict access to only the needed endpoints. This keeps access secure for some squadre e apps using the API.
Test on a small set of pages first by running your content through the API and comparing against native references. If you see unwanted changes or inconsistent glossaries, adjust your glossary and retry until the results align.
Want a faster setup? Save the key in a secure vault, reference it in your deployment scripts, and verify in tempo reale translations on your website after every publish. This approach keeps access straightforward for youre team and makes automation reliable.
Ready to begin? Open the API section in DeepL, create an account, copy the key, and paste it into your apps configuration. You’ll see results quickly as content flows from your blog to websites with translations.
Choose the Right DeepL API Plan and Enable Access
Looking to scale translations across many markets? Choose Pro or Business to match your translation volume and access needs. If your workflow includes italian content and other languages, pick a plan that supports neural translations, higher quotas, and dedicated support. Keep a single API key for your apps to simplify management, and set access controls for your team without exposing credentials. If you started with a smaller project, you can upgrade later as needs grow.
Plan options and criteria
Step 1: estimate monthly translations by market and language to gauge required quotas. Step 2: confirm language coverage and the neural option for accuracy. Step 3: compare per-use pricing and monthly limits across Starter, Pro, and Business plans. If your companys team manages a blog, ensure you have shared access tokens and clear rotation policies. Also verify that analytics, usage reports, and simple throttling are available to prevent overages.
Enable Access
Enable access by generating an API key in the DeepL dashboard under the chosen plan. Assign the key to your environment and implement safeguards: IP restrictions, scope limits, and periodic rotation. Use the key in code via environment variables, not inline in your code. Test with a sample italian sentence to verify neural translations and get outputs that match your expectations exactly. Setup alerts and logs so your team can react quickly if issues appear.
Generate a New API Key in the DeepL Pro Console
Generate a new API key now to secure access for them and improve control over each deepls integration. Keep keys out of client code and prepare a labeled key for each client to track usage and permission clearly.
Sign in to the DeepL Pro Console, go to API, and click Create New Key. Give it a descriptive name like creddyme-prod or ClientA-translation to keep context clear time after time. Choose the permission level that matches the uses you need: generate for full translation tasks, or ready read-only access for monitoring, then confirm to generate the key. This key will be used by apps that translates content across multiple languages, so plan permissions carefully.
Copy the key immediately and store it in a secure secrets vault. The console shows the key only once; if you lose it, generate a new one and revoke the old. For creddyme workflows, this approach keeps clients' data safe and minimizes risk when you deploy updates. Then you can start using the key in your server environment and in your CI/CD pipelines.
If you manage different projects, create separate keys per project to keep different uses and quotas distinct. This makes it easy to show which clients are getting value and where to allocate resources. Use the new keys with environment variables in your integration, not in code, to protect the key from exposure.
In-console steps
What to do in the console: sign in, open API, click Create New Key, name the key, set permission, generate, copy, and store securely. Then test with a small post to your staging environment to verify context and translation accuracy before going live. The immediate feedback helps you see if you need to adjust timeout, retry behavior, or caching to avoid extra calls that waste time and money.
Usage and rotation best practices
Use the API key only for server-side usage (no embedding in frontend code). Using a dedicated key per client helps auditing and throttling. When you need to rotate, generate a new key, update your apps in a rolling fashion, and revoke the old token after you verify the results. Post translations to your app and monitor the impact. Keep the context clear for every integration; this helps you show value to clients and stakeholders. The advanced setups may require a technical approach to vaulting and CI/CD integration, but the payoff is much lower risk and higher reliability.
Define Client Credential Fields, Legal Consent, and Data Handling
Define the client credential fields before enabling API access: auth_key (or api_key), endpoint, and optional identifiers like client_id and client_secret. Validate that each field is non-empty, matches expected formats, and is scoped to your environment (sandbox vs production).
Client Credential Fields
Store credentials in a secure vault; avoid embedding in UI code. The core fields determine access to translations and the rate limits you can hit. Implement next-step checks: generate the key, record its scope, and lock it behind a wall of secrets. Use languages supported by the service, with explicit mappings for each pair; for example, italian translations are allowed only when approved by policy. Maintain rotation cadence, and monitor usage in real time to catch mistakes before they affect throughput or accuracy. If youre unsure, test with a small sample to prevent broad impact.
| Field | Description | Richiesto | Example | Validazione |
|---|---|---|---|---|
| auth_key | DeepL API access token | Yes | sk_live_abc123 | 32-128 caratteri, alfanumerici |
| endpoint | API base URL | Yes | https://api.deepl.com/v2/translate | URL che inizia con https:// |
| client_id | OAuth client identifier (opzionale in alcuni flussi) | No | cli_00123 | alfanumerico con underscore |
| client_secret | Chiave segreta per l'utilizzo lato server | No | secret_abcdefghijklmnopqrstuvwxyz | min 24 chars |
| scope | Autorizzazioni concesse a questa chiave | Yes | translations:read,translations:write | comma-separated |
| expires_at | Token expiry timestamp | No | 2025-12-31T23:59:00Z | ISO 8601 |
Successivamente, documentare le regole di gestione dei dati: definire quali dati vengono raccolti (testo, coppie linguistiche, metriche di utilizzo), come vengono trasferiti (crittografia in transito), dove vengono archiviati (archiviazione sicura) e quando vengono eliminati. Le politiche di conservazione basate sul tempo aiutano a rimanere conformi tra le diverse regioni, incluse lingue come l'italiano. È possibile fornire opzioni per elaborare il testo senza traduzioni quando manca il consenso e per eseguire controlli in tempo reale o elaborazione batch secondo necessità. Lei è responsabile dell'ottenimento del consenso e della conservazione di un registro chiaro dello stato del consenso. Prima di abilitare la traduzione, confermare che gli utenti sappiano come verranno utilizzati i loro dati e che lei fornisca un modo per opporsi all'elaborazione se il consenso non viene concesso.
Archivia, proteggi e ruota le chiavi API tra gli ambienti
Memorizzare tutte le chiavi API e le credenziali in un vault dedicato per i segreti invece che nel codice, nei file di configurazione o nei log. Abbiamo iniziato a centralizzare le chiavi con un footprint primario specifico per ambiente e a ruotarle a intervalli fissi per ridurre l'esposizione. Quando si generano chiavi, contrassegnarle per ambiente (dev, test, stage, prod) e applicare controlli di accesso che impongano il principio del privilegio minimo, in modo che sviluppatori e servizi accedano solo a ciò di cui hanno bisogno. Ciò previene errori e isola le credenziali dai team non correlati. Iniziare con un flusso di lavoro centralizzato a cui il team può pubblicare e monitorare.
Prima di iniziare, definisci i ritmi di rotazione e come passare le credenziali alle pipeline CI/CD. Molti team si affidano all'automazione; implementa una rotazione senza interruzioni in modo che le pipeline prelevino sempre chiavi fresche anziché incorporare valori statici. Usa un muro di difesa: monitora l'utilizzo con avvisi; se una chiave non viene utilizzata per un periodo definito, revoca e ruota. Vorrai documentare ogni passaggio di rotazione per ridurre gli errori e migliorare la tracciabilità. Questo approccio supporta stack multilingua e mantiene le credenziali fuori dalla sorgente, rendendo più facile per il tuo team passare le credenziali in modo sicuro tra i servizi.
Archiviazione sicura e controlli di accesso
Inserire le chiavi in un gestore di segreti con policy IAM granulari. Creare una chiave primaria per ogni ambiente e ruotarla indipendentemente; concedere l'accesso solo ai servizi e ai membri del team che ne hanno bisogno. Utilizzare credenziali a breve termine e applicare l'autenticazione a più fattori quando possibile. Registrare gli eventi di accesso e di rotazione, memorizzandoli in un registro centralizzato per l'audit. Per gli sviluppatori, stabilire un flusso di lavoro semplice: generare una coppia di credenziali, passarla al servizio, quindi revocarla se inutilizzata dopo un periodo definito. Ciò supporta i linguaggi su più stack e mantiene le credenziali al di fuori del codice sorgente.
Rotazione e revisione
Define rotation cadences by environment: e.g., 30 days for dev, 90 days for prod, with immediate rotation after a suspected leak. Use automation to generate new credentials, update services, and revoke old ones without downtime. when a change occurs, publish a post in your team's status channel and verify that all endpoints received the new key. Keep an evidence trail for audits that shows who started rotation, when, and the outcome. this helps you improve security posture and reduce mistakes across teams and languages.
Test, Risoluzione problemi e Verifica dell'utilizzo delle API Key durante l'onboarding del Cliente
Utilizza una chiave API di test dedicata in un account sandbox per verificare i flussi di onboarding; conserva le chiavi di produzione in un caveau sicuro e non esporle ai client. Questo riduce il rischio e rivela le configurazioni errate in anticipo.
- Passo 1 – Crea una chiave di test ristretta: limita i permessi al flusso di lavoro di onboarding (solo traduzione, controlli per lingua), associa a un account di test, abilita l'elenco bianco IP e imposta una breve scadenza. Tieni la chiave fuori dalle applicazioni client e monitora l'utilizzo durante la finestra di onboarding.
- Step 2 – Valida con un controllo leggero e in tempo reale: esegui una singola chiamata che traduce una frase in italiano o rileva la lingua, e conferma lo stato della risposta e i dati di utilizzo. Usa target_lang IT per verificare la gestione della lingua e assicurarti che il risultato corrisponda alle aspettative. Questo test dovrebbe richiedere solo pochi secondi e non deve consumare quote di produzione.
- Step 3 – Probe con un test di salute python: recupera un payload di traduzione minimo e conferma una risposta riuscita con i campi previsti. In python, leggi la chiave da una sorgente sicura, pubblica all'endpoint di traduzione e verifica che il testo tradotto appaia nel payload.
- Passaggio 4 – Abilita il monitoraggio in tempo reale e gli avvisi contestuali: traccia quale account, app e lingua di destinazione stanno utilizzando la chiave, insieme all'ora delle richieste. Crea dashboard che mostrino l'utilizzo per contesto, tempo e lingue di destinazione, e manda avvisi in caso di picchi, origini insolite o tassi di errore eccessivi. Questo ti aiuta a vedere i modelli tra le app che stanno ricevendo un'alta domanda.
- Step 5 – Crea un audit trail per l'onboarding: registra chi ha creato la chiave, quando, quali autorizzazioni sono state concesse, gli IP che hanno avuto accesso alla chiave e i punti finali esatti utilizzati. Salva gli eventi con un key_id, account_id univoco e un timestamp per un facile recupero durante le revisioni, soprattutto per i clienti internazionali e i progetti multilingue.
- Passaggio 6 – Risolvi rapidamente i problemi comuni: verifica che la chiave sia attiva e associata all'account corretto, conferma che le autorizzazioni corrispondano all'ambito di onboarding, controlla le quote e i limiti di frequenza e convalida il payload della richiesta e l'endpoint. Se una richiesta fallisce, testa prima con un payload minimo, quindi passa alle traduzioni complete una volta che la chiamata di base ha successo.
- Step 7 – Prepara il passaggio di consegne alla produzione: al completamento dell'onboarding, ruota la chiave di test nella produzione o sostituiscila con una chiave di produzione che corrisponda esattamente alle aree di applicazione previste. Limita l'accesso alle chiavi di produzione, registra la sostituzione e verifica che tutto il monitoraggio e i controlli di audit vengano mantenuti con la nuova chiave. Questo mantiene il tuo flusso di lavoro efficiente e verificabile.
- Step 8 – Documentazione e formazione per i clienti: fornire istruzioni chiare su come funziona il flusso di onboarding, inclusi gli ambiti delle autorizzazioni, i limiti di utilizzo e le politiche di rotazione. Includere un breve video walkthrough su YouTube per i team, più esempi multilingue per supportare i clienti internazionali. Assicurarsi che la documentazione mostri come creare account, gestire chiavi e monitorare l'utilizzo tra app e lingue.
Mantenere il processo semplice, ripetibile e trasparente. Mantenendo una visibilità in tempo reale, registri di revisione precisi e una rigorosa governance delle chiavi, si riduce il rischio e si migliora la fiducia del cliente durante l'onboarding.
