> ## 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 LobeChat

> Platform API guide - Ace Data Cloud

[LobeChat](https://lobehub.com/) è un client AI open source che supporta plugin, knowledge base e self-hosting, utilizzabile nella versione online o tramite distribuzione Docker. Supporta endpoint compatibili con OpenAI personalizzati, pertanto può integrarsi con Ace Data Cloud. Questo articolo presenta il processo di configurazione.

## Procedura di richiesta

Per integrare Ace Data Cloud in LobeChat, vai prima alla [console di Ace Data Cloud](https://platform.acedata.cloud/console/applications), ottieni il tuo API Token e conservalo per l'uso successivo.

![Ottenere la API Key di Ace Data Cloud](https://cdn.acedata.cloud/dvc3cg.jpg)

Se non hai ancora effettuato l'accesso o la registrazione, verrai automaticamente reindirizzato alla pagina di accesso per registrarti ed effettuare l'accesso; dopo l'accesso e la registrazione tornerai automaticamente alla pagina corrente.

Alla prima richiesta vengono concessi crediti gratuiti, che consentono di provare gratuitamente i servizi di modelli di Ace Data Cloud.

## Configurare Ace Data Cloud

Accedi a **Impostazioni applicazione → Modelli linguistici** di LobeChat, trova e abilita la scheda **OpenAI**, quindi inserisci:

| Campo | Valore | Descrizione |
| - | - | - |
| API Key | Il tuo Token di Ace Data Cloud | Token copiato dalla console |
| Indirizzo proxy API | `https://api.acedata.cloud/v1` | **Deve terminare con `/v1`** |
| Modalità richiesta client | Abilitata | Connessione diretta del browser, la Key non passa attraverso il server LobeChat |

![Interfaccia di configurazione OpenAI Provider di LobeChat](https://cdn.acedata.cloud/629ef9d3084a.png)

> Quando utilizzi l'interfaccia Chat Completions, mantieni Responses API Specification disabilitata.

LobeChat non aggiunge automaticamente `/v1` al Base URL; il percorso della richiesta è direttamente `{Indirizzo proxy API}/chat/completions`:

| Indirizzo proxy API | Richiesta effettiva | Risultato |
| - | - | - |
| `https://api.acedata.cloud/v1` | `https://api.acedata.cloud/v1/chat/completions` | Corretto |
| `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/chat/completions` | Utilizzabile anche |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (non esiste `/v1` sotto `/openai`) |
| `https://api.acedata.cloud` | `https://api.acedata.cloud/chat/completions` | 404 (manca `/v1`) |

Per impostazione predefinita, LobeChat chiama `/v1/models` per recuperare automaticamente i modelli. Quando i modelli restituiti da Ace Data Cloud sono numerosi, l'interfaccia può diventare molto lunga; si consiglia di compilare manualmente una allow list in «Elenco modelli → Nomi modelli personalizzati», separandoli con virgole inglesi. Se desideri personalizzare il nome visualizzato, puoi usare `=`, nel formato `MODEL_ID=Nome visualizzato`.

## Selezionare un modello

Il catalogo dei modelli verrà aggiornato continuamente. Dai priorità all'elenco dei modelli caricato automaticamente dal client; se devi compilarlo manualmente, richiedi prima `GET https://api.acedata.cloud/v1/models` per ottenere l'ID del modello corrente, quindi seleziona in base alle capacità di contesto, immagini e chiamata di strumenti supportate dal client.

## Verificare l'integrazione

Se non sei sicuro che il problema sia in LobeChat o nella rete, puoi prima verificare direttamente l'endpoint con curl (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: ricarica dalla [console](https://platform.acedata.cloud/console/applications).

## Avanzato: self-hosting con Docker

Se desideri distribuire una versione privata per l'uso del team, puoi avviarla con un comando Docker in una riga (sostituisci `{token}` con il tuo Token):

```bash theme={null}
docker run -d \
  --name lobe-chat \
  -p 3210:3210 \
  -e OPENAI_API_KEY={token} \
  -e OPENAI_PROXY_URL=https://api.acedata.cloud/v1 \
  -e ACCESS_CODE=your-secret-password \
  -e OPENAI_MODEL_LIST="MODEL_ID" \
  lobehub/lobe-chat:latest
```

Apri `http://IP-del-tuo-server:3210`, inserisci `ACCESS_CODE` per utilizzarlo; i membri del team non devono compilare individualmente la Key. Per la descrizione completa delle variabili d'ambiente come `OPENAI_API_KEY`, `OPENAI_PROXY_URL` e `OPENAI_MODEL_LIST` utilizzate sopra, consulta la [documentazione delle variabili d'ambiente dei provider di modelli di LobeChat](https://lobehub.com/docs/self-hosting/environment-variables/model-provider). Se utilizzi un proxy inverso nginx con HTTPS, assicurati di aggiungere `proxy_buffering off;`, altrimenti le risposte in streaming verranno memorizzate nel buffer. Per ulteriori modalità di distribuzione, consulta la [guida introduttiva al self-hosting di LobeChat](https://lobehub.com/docs/self-hosting/start) e la [distribuzione Docker Compose](https://lobehub.com/docs/self-hosting/platform/docker-compose).

## Domande frequenti

### Viene visualizzato 404 Not Found

Di solito l'indirizzo proxy API è stato scritto come `.../openai/v1` oppure manca `/v1`. Modificalo in `https://api.acedata.cloud/v1`.

### L'elenco dei modelli è vuoto

Abilita l'interruttore «Modalità richiesta client»; oppure compila manualmente la allow list dei modelli in «Nomi modelli personalizzati».

### Viene visualizzato 401 Unauthorized

Verifica che nella API Key sia incollato il Token di Ace Data Cloud (senza il prefisso `Bearer`, senza spazi aggiuntivi) e che il saldo dell'applicazione di appartenenza sia sufficiente.

## Scopri di più

* [Sito ufficiale di LobeChat](https://lobehub.com/) ｜ [LobeChat GitHub](https://github.com/lobehub/lobe-chat) ｜ [Documentazione sul self-hosting](https://lobehub.com/docs/self-hosting/start)
* [Documentazione ufficiale di LobeChat per la configurazione di OpenAI Provider](https://lobehub.com/docs/usage/providers/openai)
* [Documentazione delle variabili d'ambiente dei provider di modelli di LobeChat](https://lobehub.com/docs/self-hosting/environment-variables/model-provider)
* [Documentazione API OpenAI Chat Completions di Ace Data Cloud](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Elenco dei servizi di Ace Data Cloud](https://platform.acedata.cloud/documents)
* [Console di Ace Data Cloud](https://platform.acedata.cloud/console)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.