json et markdown.
Ce document détaillera les instructions d’intégration de l’API de traduction, vous aidant à intégrer facilement et à tirer pleinement parti de la puissance de cette API. Grâce à l’API de traduction, vous pouvez facilement traduire le texte saisi dans une langue spécifique et prendre en charge des méthodes spécifiques pour afficher les résultats de traduction.
Processus de demande
Pour utiliser l’API de traduction de localisation, commencez par obtenir votre jeton API sur le tableau de bord Ace Data Cloud pour le garder en réserve.
Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion vous invitant à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle.
Un jeton API suffit pour appeler tous les services de la plateforme, sans avoir besoin de demander séparément pour chaque service. La première demande vous donnera un quota gratuit pour une expérience sans frais ; lorsque le quota est insuffisant, vous pouvez recharger le solde général sur le tableau de bord.
📘 Documentation complète : API de traduction de localisation →
Exemples de demande
Prenons un exemple d’entrée en anglais pour démontrer comment utiliser cette API. Supposons que la description en anglais soit :# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph., nous allons maintenant montrer comment télécharger la description en anglais et obtenir le résultat de traduction en chinois, tout en le présentant sous forme de markdown.
Configuration des en-têtes de demande et du corps de la demande
En-têtes de demande comprennent :accept: spécifie que la réponse doit être au format JSON, ici rempli avecapplication/json.authorization: la clé pour appeler l’API, que vous pouvez sélectionner directement après la demande.
input: le texte à traduire téléchargé.locale: la langue de traduction personnalisée.extension: la forme d’affichage des résultats de traduction personnalisée.model: le grand modèle utilisé pour la traduction, par défaut gpt-3.5.
Exemple de code
Vous pouvez voir que divers codes dans différentes langues ont déjà été générés automatiquement sur le côté droit, comme illustré :
CURL
Python
Exemple de réponse
Après une demande réussie, l’API renverra les informations de résultat de cette tâche de traduction. Par exemple :data dans le résultat, qui contient le texte traduit en chinois, tout en étant retourné sous forme de markdown, les autres informations sont les suivantes :
data, le résultat de cette tâche de traduction.model, le grand modèle de langue utilisé pour cette tâche de traduction.locale, le type de langue de traduction pour cette tâche.
Gestion des erreurs
Lors de l’appel de l’API, si une erreur se produit, l’API renverra le code d’erreur et les informations correspondantes. Par exemple :400 token_mismatched: Mauvaise demande, probablement en raison de paramètres manquants ou invalides.400 api_not_implemented: Mauvaise demande, probablement en raison de paramètres manquants ou invalides.401 invalid_token: Non autorisé, jeton d’autorisation invalide ou manquant.429 too_many_requests: Trop de demandes, vous avez dépassé la limite de taux.500 api_error: Erreur interne du serveur, quelque chose s’est mal passé sur le serveur.