Comment utiliser l'API DeepL gratuitement avec DeepLX

Dans un monde connecté, la traduction rapide et précise est cruciale. DeepL est leader, mais son API est payante. DeepLX, open-source, offre une alternative gratuite.

Louis Dupont

Louis Dupont

5 June 2025

Comment utiliser l'API DeepL gratuitement avec DeepLX

```html

Dans un monde de plus en plus interconnecté, le besoin de services de traduction rapides, précis et accessibles est primordial. DeepL est devenu un leader dans ce domaine, réputé pour ses traductions nuancées et naturelles, alimentées par une traduction automatique neuronale avancée. Cependant, l'accès à son API officielle s'accompagne souvent de coûts qui peuvent ne pas être réalisables pour tous les utilisateurs, développeurs ou projets à petite échelle. Entrez DeepLX, un projet open-source d'OwO-Network qui offre une alternative gratuite pour exploiter les puissantes capacités de traduction de DeepL.

Ce guide complet explorera ce qu'est DeepLX, ses avantages, comment l'installer et l'utiliser, les considérations cruciales concernant sa nature non officielle et comment il se compare aux offres officielles. Que vous soyez un développeur cherchant à intégrer la traduction dans vos applications, un amateur expérimentant des outils linguistiques ou simplement à la recherche de solutions de traduction rentables, comprendre DeepLX peut ouvrir de nouvelles possibilités.

💡
Vous voulez un excellent outil de test d'API qui génère une belle documentation d'API ?

Vous voulez une plateforme intégrée et tout-en-un pour que votre équipe de développeurs travaille ensemble avec une productivité maximale ?

Apidog répond à toutes vos demandes et remplace Postman à un prix beaucoup plus abordable !
button

Qu'est-ce que DeepLX ? La promesse d'une traduction gratuite et de haute qualité

À la base, DeepL est une société allemande d'IA qui fournit des services de traduction automatique reconnus pour leur précision exceptionnelle et leur capacité à saisir le contexte et les nuances linguistiques, surpassant souvent les concurrents pour de nombreuses paires de langues. Pour permettre un accès programmatique à son moteur de traduction, DeepL propose une API officielle, qui est un service payant avec différents niveaux répondant à différents volumes d'utilisation.

DeepLX, disponible sur GitHub sous OwO-Network, se présente comme une « puissante API de traduction DeepL » qui est :

Essentiellement, DeepLX agit comme un intermédiaire ou un proxy, permettant aux utilisateurs d'envoyer des demandes de traduction au backend de DeepL sans utiliser directement l'API officielle payante. Ceci est généralement réalisé par le serveur DeepLX qui effectue des requêtes à DeepL d'une manière qui imite la façon dont un utilisateur gratuit pourrait accéder au service (par exemple, via son interface web ou ses applications de bureau, bien que le mécanisme exact puisse varier et être sujet à changement).

Il est crucial de comprendre dès le départ que DeepLX est un outil non officiel. Il n'est ni développé ni approuvé par DeepL SE. Cette distinction a des implications importantes concernant la fiabilité, la stabilité et les conditions d'utilisation, qui seront discutées en détail plus tard. Le public cible de DeepLX comprend généralement les développeurs ayant besoin d'un accès API pour de petits projets, les chercheurs ou les utilisateurs pour lesquels les coûts de l'API officielle DeepL sont prohibitifs.


Pourquoi choisir DeepLX ? Avantages et bénéfices

Malgré son statut non officiel, DeepLX offre plusieurs avantages convaincants qui attirent les utilisateurs :

Ces avantages font de DeepLX une proposition intéressante pour ceux qui ont besoin des prouesses de traduction de DeepL sans les coûts associés. Cependant, ces avantages doivent être mis en balance avec les considérations découlant de son approche non officielle.


Le statut « non officiel » : considérations critiques et inconvénients potentiels

Bien que « gratuit » et « de haute qualité » soient attrayants, il est essentiel d'avoir une compréhension claire de ce que signifie « non officiel » dans le contexte de DeepLX :

Les utilisateurs doivent aborder DeepLX avec une certaine prudence, en comprenant qu'il pourrait ne pas convenir aux applications critiques pour la mission où la disponibilité garantie et l'assistance officielle sont nécessaires. Il est préférable dans les scénarios où les temps d'arrêt occasionnels ou la nécessité de dépannage sont des compromis acceptables pour un accès gratuit.


Premiers pas : installation et configuration de DeepLX

La configuration de DeepLX est généralement simple, surtout si vous connaissez Docker ou si vous exécutez des binaires précompilés. Voici les méthodes courantes :

Conditions préalables

Méthode 1 : Utilisation de Docker (recommandée pour la simplicité)

Docker est souvent le moyen le plus simple de faire fonctionner DeepLX, car il regroupe toutes les dépendances et configurations.

  1. Trouver l'image Docker : OwO-Network ou les développeurs contribuant à DeepLX fournissent généralement des images Docker sur Docker Hub. Vous pouvez rechercher deeplx sur Docker Hub ou rechercher des instructions sur le référentiel GitHub officiel de DeepLX. Les images courantes peuvent être nommées comme owonetwork/deeplx ou similaire.
  2. Extraire l'image : Ouvrez votre terminal et exécutez :
docker pull <image_name>:<tag>

(Remplacez <image_name>:<tag> par le nom réel de l'image).

  1. Exécuter le conteneur Docker :
docker run -d -p 1188:1188 --name my-deeplx <image_name>:<tag>
  1. Vérifier : vous pouvez vérifier si le conteneur est en cours d'exécution avec docker ps. Le service DeepLX doit maintenant être accessible à l'adresse http://localhost:1188.

Méthode 2 : Téléchargement de binaires précompilés

De nombreux projets open-source fournissent des exécutables précompilés pour divers systèmes d'exploitation.

  1. Accéder aux versions GitHub : accédez au référentiel GitHub officiel de DeepLX (OwO-Network/DeepLX) et recherchez la section « Versions ».
  2. Télécharger le binaire correct : vous trouverez des binaires pour différents systèmes d'exploitation et architectures (par exemple, deeplx_windows_amd64.exe, deeplx_linux_amd64, deeplx_darwin_amd64). Téléchargez celui qui correspond à votre système.
  3. Le rendre exécutable (Linux/macOS) :
chmod +x /path/to/your/deeplx_binary
  1. Exécuter le binaire :
./path/to/your/deeplx_binary [options]

Le binaire peut prendre en charge des indicateurs de ligne de commande pour la configuration (par exemple, spécifier un port avec -p <port_number> ou un jeton pour sécuriser l'instance DeepLX elle-même, bien que cela soit distinct d'une clé API DeepL). Reportez-vous à la documentation du projet pour connaître les options disponibles.

  1. Pare-feu : assurez-vous que le pare-feu de votre système autorise les connexions entrantes sur le port sur lequel DeepLX écoute (par défaut 1188) si vous avez l'intention d'y accéder à partir d'autres appareils de votre réseau.

Méthode 3 : Compilation à partir de la source (pour les utilisateurs avancés)

Si vous préférez le compiler vous-même ou si vous souhaitez les dernières modifications non publiées :

  1. Installer les dépendances de compilation : DeepLX est souvent écrit dans des langages comme Go ou Rust. Vous aurez besoin du compilateur et de la chaîne d'outils respectifs installés (par exemple, l'environnement du langage de programmation Go). Consultez le référentiel GitHub pour les instructions de compilation.
  2. Cloner le référentiel :
git clone [https://github.com/OwO-Network/DeepLX.git](https://github.com/OwO-Network/DeepLX.git)
cd DeepLX
  1. Compiler le projet : suivez les commandes de compilation spécifiées dans le README.md du référentiel ou les scripts de compilation (par exemple, go build . ou cargo build --release).
  2. Exécuter le binaire compilé : l'exécutable résultant peut ensuite être exécuté comme décrit dans la méthode 2.

Configuration initiale (côté serveur)

DeepLX lui-même est souvent conçu pour s'exécuter avec une configuration minimale. La principale chose à noter est le port sur lequel il écoute (par défaut 1188). Certaines versions ou forks peuvent permettre de définir un jeton d'accès via des arguments de ligne de commande ou des variables d'environnement (par exemple, -token YOUR_SECRET_TOKEN). Ce jeton devrait ensuite être fourni par les clients pour utiliser votre instance DeepLX, ajoutant ainsi une couche de sécurité si votre point de terminaison DeepLX est exposé.

Une fois en cours d'exécution, votre instance DeepLX doit être prête à recevoir les demandes de traduction.


Comment utiliser DeepLX : effectuer des demandes de traduction

Une fois votre instance DeepLX opérationnelle (par exemple, à l'adresse http://localhost:1188), vous pouvez commencer à envoyer des demandes de traduction à son point de terminaison API, qui est généralement /translate.

Point de terminaison API

http://<your_deeplx_host_or_ip>:<port>/translate
(par exemple, http://localhost:1188/translate si vous l'exécutez localement sur le port par défaut)

Structure d'appel d'API de base

Paramètres clés dans le corps JSON

Exemple utilisant curl

Pour traduire « Hello, world ! » de l'anglais vers l'allemand :

curl -X POST http://localhost:1188/translate \
     -H "Content-Type: application/json" \
     -d '{
           "text": "Hello, world!",
           "source_lang": "EN",
           "target_lang": "DE"
         }'

Interprétation de la réponse

Réponse réussie (par exemple, HTTP 200 OK) : la réponse sera un objet JSON contenant généralement :

Exemple de structure de réponse réussie : JSON

{
    "code": 200,
    "id": 1678886400000,
    "data": "Hallo, Welt!",
    "source_lang": "EN",
    "target_lang": "DE",
    "alternatives": [
        "Hallo Welt!"
    ]
}

Réponses d'erreur :

Utilisation de DeepLX avec des langages de programmation (exemples conceptuels)

Python (en utilisant la bibliothèque requests) : Python

import requests
import json

deeplx_url = "http://localhost:1188/translate"
text_to_translate = "The quick brown fox jumps over the lazy dog."

payload = {
    "text": text_to_translate,
    "source_lang": "EN",
    "target_lang": "ES"  # Translate to Spanish
}

headers = {
    "Content-Type": "application/json"
}

try:
    response = requests.post(deeplx_url, data=json.dumps(payload), headers=headers)
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
    
    translation_data = response.json()
    
    if translation_data.get("code") == 200:
        print(f"Original: {text_to_translate}")
        print(f"Translated: {translation_data.get('data')}")
    else:
        print(f"Error from DeepLX: {translation_data.get('message', 'Unknown error')}")

except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")
except json.JSONDecodeError:
    print("Failed to decode JSON response.")

JavaScript (en utilisant l'API Workspace dans un navigateur ou un environnement Node.js) : JavaScript

async function translateText(text, targetLang, sourceLang = "auto") {
    const deeplxUrl = "http://localhost:1188/translate"; // Adjust if your DeepLX is elsewhere
    const payload = {
        text: text,
        source_lang: sourceLang,
        target_lang: targetLang
    };

    try {
        const response = await fetch(deeplxUrl, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(payload)
        });

        if (!response.ok) {
            // Try to get error message from DeepLX if possible
            let errorMsg = `HTTP error! status: ${response.status}`;
            try {
                const errorData = await response.json();
                errorMsg = errorData.message || JSON.stringify(errorData);
            } catch (e) { /* ignore if response is not json */ }
            throw new Error(errorMsg);
        }

        const translationData = await response.json();

        if (translationData.code === 200) {
            return translationData.data;
        } else {
            throw new Error(translationData.message || `DeepLX API error code: ${translationData.code}`);
        }
    } catch (error) {
        console.error("Translation failed:", error);
        return null;
    }
}

// Example usage:
(async () => {
    const translatedText = await translateText("Welcome to the world of AI.", "JA"); // To Japanese
    if (translatedText) {
        console.log(`Translated: ${translatedText}`);
    }
})();

N'oubliez pas d'adapter deeplx_url si votre instance DeepLX ne s'exécute pas sur localhost:1188.


Intégration de DeepLX avec des applications

L'un des principaux cas d'utilisation de DeepLX est d'alimenter les fonctionnalités de traduction au sein d'autres applications sans encourir les coûts de l'API officielle. Plusieurs outils et projets ont déjà démontré des intégrations :

Approche générale de l'intégration

  1. Configurez votre instance DeepLX : assurez-vous que votre serveur DeepLX est en cours d'exécution et accessible depuis l'application qui l'utilisera.
  2. Identifier les paramètres de configuration : dans l'application avec laquelle vous souhaitez intégrer, recherchez les paramètres liés aux services de traduction ou à l'API DeepL.
  3. Pointer vers votre point de terminaison DeepLX : au lieu d'une URL d'API DeepL officielle (comme https://api-free.deepl.com/v2/translate ou https://api.deepl.com/v2/translate), vous saisirez généralement l'adresse de votre serveur DeepLX (par exemple, http://localhost:1188/translate ou http://your-server-ip:1188/translate).
  4. Gestion des clés API :
  1. Tester minutieusement : après la configuration, testez la fonctionnalité de traduction dans l'application pour vous assurer qu'elle fonctionne correctement avec votre backend DeepLX.

La facilité d'intégration dépend en grande partie de la flexibilité de la configuration du service de traduction de l'application cible.


Considérations avancées et meilleures pratiques

Pour tirer le meilleur parti de DeepLX et atténuer certains de ses problèmes potentiels, tenez compte des éléments suivants :

En étant proactif, vous pouvez améliorer la stabilité et l'utilité de votre configuration DeepLX.


Dépannage des problèmes courants de DeepLX

Rencontrer des problèmes est possible étant donné la nature de DeepLX. Voici quelques problèmes courants et comment les aborder :

Problème : erreur 429 Too Many Requests

Explore more

Fathom-R1-14B : Modèle de raisonnement IA avancé d'Inde

Fathom-R1-14B : Modèle de raisonnement IA avancé d'Inde

L'IA en expansion rapide. Fathom-R1-14B (14,8 milliards de paramètres) excelle en raisonnement mathématique et général, conçu par Fractal AI Research.

5 June 2025

Mistral Code : L'assistant de codage le plus personnalisable basé sur l'IA pour les entreprises

Mistral Code : L'assistant de codage le plus personnalisable basé sur l'IA pour les entreprises

Découvrez Mistral Code, l'IA d'aide au code la plus personnalisable pour les entreprises.

5 June 2025

Comment Claude Code transforme le codage de l'IA en 2025

Comment Claude Code transforme le codage de l'IA en 2025

Découvrez Claude Code en 2025 : codage IA révolutionné. Fonctionnalités, démo, et pourquoi il gagne du terrain après Windsurf d'Anthropic. Indispensable !

5 June 2025

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API