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 Python, 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
  • Environnement Python 3.7 ou supérieur
  • Installer la bibliothèque requests : pip install requests

Utilisation de base

Le point d’accès principal de 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 Python :
import requests

url = "https://api.acedata.cloud/aichat/conversations"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "model": "gpt-4o",
    "question": "什么是人工智能?",
    "stateful": true
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Veuillez remplacer YOUR_API_TOKEN par le Token réel obtenu sur la plateforme Ace Data Cloud.

Gestion de la réponse

Après un appel réussi, l’API retourne des données au format JSON. Il est recommandé de vérifier le code HTTP :
if response.status_code == 200:
    result = response.json()
    print("Appel réussi :", result)
else:
    print(f"Échec de l’appel, code d’état : {response.status_code}")
    print(response.text)

Utilisation avancée

Pour les API supportant les tâches asynchrones, vous pouvez obtenir les résultats via une URL de rappel :
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Les résultats seront poussés vers votre serveur via l’URL de rappel

Gestion des erreurs

Codes d’erreur courants :
Code d’étatDescription
401Échec d’authentification, vérifiez le Token API
403Solde insuffisant ou accès refusé
429Fréquence de requêtes dépassée
500Erreur interne du serveur

Étapes suivantes