> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Utilizzare Ace Data Cloud in ChatBox > Platform API guide - Ace Data Cloud [ChatBox](https://chatboxai.app/) è un client AI open source che supporta Windows, macOS, Linux, iOS, Android e Web. Supporta fornitori di servizi personalizzati di tipo «OpenAI API», quindi può connettersi direttamente ad Ace Data Cloud. Questo articolo descrive il processo di configurazione. ## Procedura di richiesta Per connettere Ace Data Cloud in ChatBox, innanzitutto vai alla [Console di Ace Data Cloud](https://platform.acedata.cloud/console/applications), ottieni il tuo API Token e conservalo come riserva. ![Ottenere Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg) Se non hai ancora effettuato l'accesso o non ti sei registrato, verrai automaticamente reindirizzato alla pagina di accesso che ti invita a registrarti e ad accedere; dopo l'accesso e la registrazione tornerai automaticamente alla pagina corrente. Alla prima richiesta verrà assegnata una quota gratuita, che consente di provare gratuitamente i servizi di modelli di Ace Data Cloud. ## Scaricare ChatBox Vai al [sito ufficiale di ChatBox](https://chatboxai.app/) per scaricare in base alla piattaforma, oppure usa direttamente la [versione Web](https://web.chatboxai.app/) senza installazione: * Desktop: Windows `.exe`, macOS `.dmg` (distinzione tra Intel / Apple Silicon), Linux AppImage * Mobile: App Store, Google Play, link diretto Android dal sito ufficiale ## Configurare Ace Data Cloud Avvia ChatBox, vai su **Impostazioni → Modelli → Aggiungi Provider personalizzato**, imposta **API Mode** su **OpenAI API Compatible**, quindi inserisci: | Campo | Valore | Descrizione | | - | - | - | | Chiave API | Il tuo Ace Data Cloud Token | Il Token copiato dalla console | | API Host | `https://api.acedata.cloud` | Inserisci solo il dominio radice, **non includere `/openai` o `/v1`** | | API Path | `/v1/chat/completions` | Il valore predefinito di ChatBox è `/chat/completions`, deve essere modificato manualmente in questo | ![Interfaccia di configurazione del Provider Ace Data Cloud in ChatBox](https://cdn.acedata.cloud/3789c8e3dd4d.png) Il percorso di richiesta di ChatBox è `{API Host} + {API Path}`, quindi per Host è sufficiente inserire solo il dominio radice: | API Host | Richiesta finale | Risultato | | - | - | - | | `https://api.acedata.cloud` | `https://api.acedata.cloud/v1/chat/completions` | Corretto | | `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (non esiste `/v1` sotto `/openai`) | | `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/v1/chat/completions` | 404 | ChatBox non chiama automaticamente `/v1/models`; devi inserire manualmente gli ID dei modelli (uno per riga) nel campo «Modelli personalizzati» in fondo alla pagina delle impostazioni dei modelli. Dopo il salvataggio, potrai selezionarli dal menu a discesa dei modelli nell'interfaccia di conversazione. Gli interruttori delle funzionalità, la finestra di contesto e il limite di output devono essere compilati in base al contratto corrente del modello selezionato, senza copiare i valori di altri modelli. ## Selezionare un modello Il catalogo dei modelli viene aggiornato continuamente. Dai priorità all'elenco di modelli caricato automaticamente dal client; se devi inserirli manualmente, richiedi prima `GET https://api.acedata.cloud/v1/models` per ottenere gli ID dei modelli correnti, quindi scegli in base alle capacità di contesto, immagini e chiamate agli strumenti supportate dal client. ## Verificare l'integrazione Se non sei sicuro che il problema sia in ChatBox o nella rete, puoi prima usare curl per verificare direttamente l'endpoint (sostituisci `{token}` con il tuo Token): ```bash theme={null} curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \ -H 'Authorization: Bearer {token}' \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL_ID", "messages": [{"role": "user", "content": "ping"}] }' ``` La restituzione di un oggetto `chat.completion` compatibile con OpenAI indica che sia il Token sia l'endpoint sono pronti; se viene restituito `HTTP 403 used_up`, significa che il Token è valido ma il saldo è insufficiente: è sufficiente effettuare una ricarica nella [console](https://platform.acedata.cloud/console/applications). ## Domande frequenti ### Viene visualizzato 404 Not Found Di solito è perché sono stati aggiunti in eccesso `/openai` o `/v1` all'API Host. Per Host inserisci solo `https://api.acedata.cloud` e lascia il percorso al valore predefinito `/v1/chat/completions`. ### Viene visualizzato 401 / token\_mismatched Verifica che nella «Chiave API» sia incollato il Token di Ace Data Cloud (senza il prefisso `Bearer`, senza spazi aggiuntivi) e che il saldo dell'applicazione associata sia sufficiente. ### Il modello non è visibile nel menu a discesa dei modelli ChatBox non recupera automaticamente l'elenco dei modelli: devi inserire manualmente gli ID dei modelli nel campo «Modelli personalizzati» e salvare. ### Vuoi generare immagini in ChatBox La generazione di immagini di Ace Data Cloud è un'Images API separata (`/openai/images/generations`), con un percorso diverso dall'interfaccia di conversazione, e l'accesso alle immagini di ChatBox non può connettersi direttamente. Se devi generare immagini, consulta la [documentazione dell'API di generazione immagini](https://platform.acedata.cloud/documents/openai-images-generations) per effettuare chiamate con curl / SDK. ## Per saperne di più * [Sito ufficiale di ChatBox](https://chatboxai.app/) ｜ [ChatBox GitHub](https://github.com/chatboxai/chatbox) * [Guida ufficiale ChatBox per l'integrazione di servizi compatibili con OpenAI (BYOK)](https://chatboxai.app/en/guide/byok/openai) * [Documentazione API Ace Data Cloud OpenAI Chat Completions](https://platform.acedata.cloud/documents/openai-chat-completions) * [Documentazione API Ace Data Cloud per la generazione di immagini](https://platform.acedata.cloud/documents/openai-images-generations) * [Elenco dei servizi Ace Data Cloud](https://platform.acedata.cloud/documents) * [Console Ace Data Cloud](https://platform.acedata.cloud/console) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.