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

# Guida alla configurazione di modelli personalizzati in Cherry Studio

> Platform API guide - Ace Data Cloud

## 1. Ottenere l'API Key

Apri l'[elenco delle applicazioni Ace Data Cloud](https://platform.acedata.cloud/console/applications), accedi a un'applicazione disponibile e copia l'API Key.

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

## 2. Aggiungere un Provider

Apri Cherry Studio, vai su **Impostazioni → Servizi modello → Aggiungi provider** e compila:

| Campo | Valore |
| - | - |
| Nome del provider | `Ace Data Cloud` |
| Tipo di provider | `OpenAI` |
| API Key | L'API Key appena copiata |
| Indirizzo API | `https://api.acedata.cloud` |

![Interfaccia di configurazione per aggiungere il Provider Ace Data Cloud in Cherry Studio](https://cdn.acedata.cloud/b67a927eae62.png)

Cherry Studio completerà automaticamente `/v1/chat/completions` per il tipo OpenAI. Quando usi l'endpoint generale, non aggiungere `#` alla fine dell'indirizzo e non è necessario creare più Provider per famiglie di modelli diverse.

## 3. Aggiungere e abilitare i modelli

1. Fai clic su **Ottieni elenco modelli**; se la versione corrente non supporta il recupero automatico, vai al [catalogo dei modelli](https://platform.acedata.cloud/models) per visualizzare e poi aggiungere manualmente il nome del modello di destinazione, ad esempio `claude-opus-5`, `gpt-6-sol`.
2. Fai clic sul pulsante di verifica accanto all'API Key per convalidare la connessione.
3. Attiva l'interruttore **Abilita** del Provider.
4. Seleziona il modello appena aggiunto nel selettore dei modelli di conversazione.

![Provider e elenco dei modelli di Cherry Studio](https://cdn.acedata.cloud/149de1d088bf.png)

> Dopo aver completato il recupero o l'aggiunta manuale del modello, attiva l'interruttore del Provider nell'angolo in alto a destra.

Invia `Rispondi solo OK` e verifica la chiamata nella [cronologia di utilizzo](https://platform.acedata.cloud/console/usages). Per un errore 401 controlla la Key; se il modello non viene visualizzato, controlla se il Provider è abilitato; per un errore 404 controlla se il nome del modello inserito manualmente corrisponde esattamente all'`id` nel catalogo.

## Informazioni su GPT Image 2

Il normale Provider di chat personalizzato di Cherry Studio non può chiamare direttamente l'Images API. La generazione e la modifica di `gpt-image-2` devono utilizzare le interfacce dedicate di Ace Data Cloud:

* [Generazione immagini GPT Image 2](https://platform.acedata.cloud/documents/openai-images-generations)
* [Modifica immagini GPT Image 2](https://platform.acedata.cloud/documents/openai-images-edits)

Non inserire `/openai/images/generations` nel Provider di chat.

## Riferimenti ufficiali

* [Cherry Studio](https://cherry-ai.com/)
* [Provider personalizzati](https://docs.cherry-ai.com/pre-basic/providers/zi-ding-yi-fu-wu-shang)


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