Passer au contenu principal

​
Introduction

Localization est un service d’outils fourni par Ace Data Cloud, un service de traduction localisée par IA. Grâce à l’API unifiée d’Ace Data Cloud, vous pouvez intégrer rapidement Localization avec JavaScript pour réaliser la traduction de Markdown, la traduction JSON, la prise en charge de 18 langues, le maintien du format, etc.

​
Prérequis

  • Posséder un compte Ace Data Cloud et obtenir un jeton API
  • Node.js 18+ ou un environnement navigateur moderne

​
Utilisation de base

Le point d’accès principal de l’API Localization est : 
POST https://api.acedata.cloud/localization/translate
Cet exemple utilise le modèle gpt-4. Les modèles disponibles incluent : gpt-3.5, gpt-4. Exemple complet de code JavaScript : 
const response = await fetch("https://api.acedata.cloud/localization/translate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "input": "# 欢迎使用\n\n这是一段示例文本。",
  "locale": "en",
  "extension": "md",
  "model": "gpt-4"
}),
});

const result = await response.json();
console.log(result);
Veuillez remplacer YOUR_API_TOKEN par le jeton réel obtenu sur la plateforme Ace Data Cloud.

​
Gestion de la réponse

Il est recommandé de vérifier le code de statut de la réponse et de gérer les erreurs : 
if (response.ok) {
  const result = await response.json();
  console.log("Appel réussi :", result);
} else {
  console.error(`Échec de l'appel, code de statut : ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulation Node.js

Il est conseillé d’encapsuler dans une fonction réutilisable : 
async function callLocalization(data) {
  const response = await fetch("https://api.acedata.cloud/localization/translate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Erreur API : ${response.status}`);
  return response.json();
}

​
Gestion des erreurs

Codes d’erreur courants :
Code de statutDescription
401Échec d’authentification, vérifiez le jeton API
403Solde insuffisant ou accès refusé
429Limite de fréquence dépassée
500Erreur interne du serveur

​
Étapes suivantes