Cherry Studio

Cherry Studio può collegarsi a HiAPI tramite un provider personalizzato. Un solo provider può contenere tre endpoint insieme — OpenAI, Anthropic e OpenAI Responses — ciascuno per un protocollo diverso, e scegli l’endpoint che corrisponde al protocollo supportato da un modello. I passaggi seguenti usano claude-opus-5-5, gpt-6-astra e deepseek-v4.1-flash come esempi; questo tutorial è stato verificato su Cherry Studio 2.1.7.

1. Preparare una chiave API HiAPI

Prepara una chiave come descritto in Ottieni una chiave API, fai clic sull’icona di copia accanto alla chiave e copia la chiave API HiAPI completa da inserire qui sotto in Cherry Studio.

2. Scegliere il protocollo

I modelli di esempio di questa pagina sono stati tutti testati con la tabella qui sopra. Per un altro modello, scegli prima l’endpoint dalla tabella e invia un messaggio per provarlo; se ricevi 400 does not support this endpoint, passa a un altro endpoint.

3. Aggiungere il provider

3.1 Da dove iniziare

Fai clic su Settings → Model Providers → Add Provider (设置 → 模型服务 → 添加提供商).

3.2 Inserire lo stesso indirizzo nei tre endpoint

Inserisci https://api.hiapi.ai in tutti e tre gli endpoint, senza /v1; Cherry Studio aggiunge il percorso da sé. Questo è diverso dagli altri strumenti.

3.3 Controllare i percorsi reali delle richieste

Se non corrispondono: quando vedi /v1/v1/..., cambia il campo in https://api.hiapi.ai; quando manca /v1, cambialo in https://api.hiapi.ai/v1.

4. Aggiungere i modelli e impostare il loro protocollo

Dopo aver aggiunto il nome di un modello, fai clic sull’icona della matita del modello per aprire Edit Model (编辑模型), scegli il Chat protocol (对话协议) che corrisponde al protocollo del modello e imposta Max output tokens (最大输出 Token).

4.1 Esempi di protocollo

Usando i tre modelli seguenti, aggiungi prima i nomi dei modelli:

claude-opus-5-5
gpt-6-astra
deepseek-v4.1-flash

Poi fai clic sull’icona della matita di un modello → Edit Model (编辑模型) e scegli il protocollo di chat come segue:

5. Verificare

Dopo aver cambiato le impostazioni, avvia una nuova chat per provare; le chat vecchie conservano i parametri in cache.

5.1 Chat

Avvia una nuova chat e invia “Ciao, presentati in una frase.” con ciascun modello configurato; una risposta normale significa che il collegamento funziona.

5.2 Tool calling

Configura MCP come descritto nella sezione Cherry Studio della guida alla configurazione di MCP (un server integrato o uno installato dal marketplace), poi crea tool-call-test.txt in una cartella a cui MCP può accedere, scrivi una riga hello hiapi e salva. Poi invia “Usa una sola volta lo strumento di lettura file. Leggi l’intero contenuto di tool-call-test.txt e restituiscilo esattamente com’è. Non modificare il file, non leggere altri file e non indovinare il contenuto dal nome del file.” Compare una chiamata allo strumento che restituisce hello hiapi.

6. Risoluzione dei problemi

Qui sono elencati solo i problemi specifici di Cherry Studio. Per gli errori comuni come 401, 404 e 429, vedi Errori comuni.