Passer au contenu principal

Introduction

AI Chat est un service de chat IA fourni par Ace Data Cloud, un service de dialogue IA multi-modèles. Grâce à l’API unifiée d’Ace Data Cloud, vous pouvez intégrer rapidement AI Chat avec JavaScript, en bénéficiant du support multi-modèles, des conversations avec état, des rôles prédéfinis, etc.

Prérequis

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

Utilisation de base

Le point d’entrée principal pour appeler l’API AI Chat est :
POST https://api.acedata.cloud/aichat/conversations
Cet exemple utilise le modèle gpt-4o.
Les modèles disponibles incluent : gpt-4o, gpt-4, deepseek-r1, grok-3.
Exemple complet de code JavaScript :
const response = await fetch("https://api.acedata.cloud/aichat/conversations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "gpt-4o",
  "question": "什么是人工智能?",
  "stateful": true
}),
});

const result = await response.json();
console.log(result);
Veuillez remplacer YOUR_API_TOKEN par le token 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);
}

Enveloppement Node.js

Il est conseillé d’encapsuler dans une fonction réutilisable :
async function callAIChat(data) {
  const response = await fetch("https://api.acedata.cloud/aichat/conversations", {
    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 statutDescription
401Échec d’authentification, vérifiez le token API
403Solde insuffisant ou accès refusé
429Limite de fréquence dépassée
500Erreur interne du serveur

Étapes suivantes