Passer au contenu principal
La principale fonctionnalité de l’API de traduction de localisation est de permettre d’obtenir un texte traduit en entrant le texte à traduire, tout en permettant de personnaliser la langue de traduction, et les résultats de traduction peuvent être fournis sous deux formats principaux : 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 d’entrée 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 →

​
Exemple 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 comme application/json.
  • authorization : clé pour appeler l’API, que vous pouvez sélectionner directement après la demande.
Corps de la demande comprend :
  • input : le contenu à traduire. Transmettez une chaîne lorsque extension=md, transmettez un objet JSON lorsque extension=json.
  • locale : langue de traduction personnalisée.
  • extension : format du contenu d’entrée, optionnel md ou json.
  • model : modèle de grande taille utilisé pour la traduction, par défaut gpt-3.5.
extension doit correspondre au type input ; une chaîne ne peut pas utiliser json, un objet JSON ne peut pas utiliser md. Configurez comme illustré ci-dessous :

​
Exemple de code

Vous pouvez voir que divers langages de code ont déjà été générés automatiquement sur le côté droit, comme illustré :

Voici quelques exemples de code :

​
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 :
On peut voir qu’il y a un champ 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 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.

​
Exemple de réponse d’erreur

​
Conclusion

Grâce à ce document, vous avez compris comment utiliser l’API de traduction de localisation pour traduire facilement le texte d’entrée dans une langue spécifique, tout en prenant en charge des méthodes spécifiques pour afficher les résultats de traduction. Nous espérons que ce document vous aidera à mieux intégrer et utiliser cette API. Si vous avez des questions, n’hésitez pas à contacter notre équipe de support technique.