Vai al contenuto principale

​
Introduzione

AI Chat è un servizio di chat AI fornito da Ace Data Cloud, un servizio di dialogo AI multi-modello. Attraverso l’API unificata di Ace Data Cloud, puoi integrare rapidamente AI Chat con Python, supportando funzionalità come modelli multipli, conversazioni con stato e ruoli preimpostati.

​
Prerequisiti

  • Possedere un account Ace Data Cloud e ottenere un API Token
  • Ambiente Python 3.7 o superiore
  • Installare la libreria requests: pip install requests

​
Uso Base

L’endpoint principale per chiamare l’API AI Chat è: 
POST https://api.acedata.cloud/aichat/conversations
In questo esempio si utilizza il modello gpt-4o. I modelli disponibili includono: gpt-4o, gpt-4, deepseek-r1, grok-3. Esempio completo di codice 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)
Sostituisci YOUR_API_TOKEN con il Token reale ottenuto dalla piattaforma Ace Data Cloud.

​
Gestione della Risposta

Dopo una chiamata riuscita, l’API restituisce dati in formato JSON. Si consiglia di verificare il codice di stato HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Chiamata riuscita:", result)
else:
    print(f"Chiamata fallita, codice stato: {response.status_code}")
    print(response.text)

​
Uso Avanzato

Per le API che supportano task asincroni, è possibile ottenere i risultati tramite un URL di callback: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# I risultati saranno inviati al tuo server tramite l'URL di callback

​
Gestione degli Errori

Codici di errore comuni:
Codice StatoDescrizione
401Autenticazione fallita, controlla il tuo API Token
403Saldo insufficiente o accesso negato
429Limite di frequenza delle richieste superato
500Errore interno del server

​
Passi Successivi