---
title: Cherry Studio | RunAPI
description: Connetti Cherry Studio a RunAPI e verifica una chat.
url: https://runapi.ai/it/docs/resources/application-practices/cherry-studio.md
canonical: https://runapi.ai/it/docs/resources/application-practices/cherry-studio
locale: it
---

> Versione HTML: https://runapi.ai/it/docs/resources/application-practices/cherry-studio
> Indice del sito per gli agenti: https://runapi.ai/llms.txt

# Cherry Studio

Connetti Cherry Studio a RunAPI con un provider OpenAI personalizzato. Crea una
Chiave API RunAPI standard nella [Guida
all'Autenticazione](https://runapi.ai/it/docs/guides/authentication.md) prima di continuare.

## Installa Cherry Studio

Installa l'applicazione desktop seguendo la [guida ufficiale al download di Cherry Studio][1], quindi apri le sue impostazioni.



[1]: https://docs.cherryai.com.cn/cherry-studio/download.html

## Aggiungi il provider RunAPI

1.  Apri **Settings -> Model Services -> + Add**.
2.  Imposta il nome del provider su `RunAPI` e il **Provider type** su
    **OpenAI**.
3.  Inserisci la tua chiave API RunAPI e imposta l'indirizzo API su
    `https://runapi.ai/v1`.
4.  Aggiungi un identificatore di modello preciso dal [Model Catalog](https://runapi.ai/it/models),
    abilita il provider e salva.

Poiché il tipo di provider è OpenAI, questo campo utilizza l'URL di base
compatibile con OpenAI di RunAPI, che include `/v1`. Cherry Studio aggiunge
`/chat/completions` per una richiesta Chat Completions, quindi non incollare
l'URL completo dell'operazione nel campo dell'indirizzo API.

## Seleziona un modello

I provider personalizzati si basano sui modelli che aggiungi. Se il selettore è vuoto,
torna all'area di gestione dei modelli del provider e aggiungi manualmente un identificatore RunAPI esatto. L'aggiunta di un modello non conferisce capacità che il modello non supporta.

## Esegui il controllo della connessione

Esegui il **Controllo connessione** con il modello salvato. Questa operazione invia una
richiesta al modello anziché limitarsi a validare il formato della chiave. Un controllo
riuscito conferma che l'URL del provider, la chiave e il modello selezionato funzionano insieme.

## Verifica la connessione

Avvia una nuova chat, seleziona il provider e il modello RunAPI, poi invia `Reply
with the word connected.` Una risposta normale, completa o in streaming, conferma
che la chat attiva sta utilizzando RunAPI.

## Risoluzione dei problemi

* **Il selettore di modelli è vuoto:** aggiungi l'identificatore esatto del modello nell'area di gestione dei modelli del provider personalizzato e conferma che il provider sia abilitato.
* **Il controllo della connessione non riesce:** conferma che un modello sia selezionato, sostituisci la chiave con una chiave standard valida e riprova.
* **La richiesta restituisce `404`:** usa `https://runapi.ai/v1` come indirizzo API; non aggiungere `/chat/completions` manualmente.
* **Text funziona ma vision o tool non funzionano:** scegli un modello che dichiari la funzionalità richiesta nel [Model Catalog](https://runapi.ai/it/models).

Per il comportamento del protocollo condiviso, utilizza la [Guida introduttiva
all'API LLM](https://runapi.ai/it/docs/guides/llm-api/quickstart.md). Per i campi di richiesta e risposta, utilizza il [Riferimento API
Chat Completions](https://runapi.ai/it/docs/api/openai/chat-completions.md).

---

## Altre risorse di RunAPI

- [Home](https://runapi.ai/it/.md)
- [Catalogo dei modelli](https://runapi.ai/it/models.md)
- [Prezzi](https://runapi.ai/it/pricing.md)
- [Fornitori](https://runapi.ai/it/models)
- [Documentazione](https://runapi.ai/it/docs/guides)
- [SDK](https://runapi.ai/it/sdk.md)
- [CLI](https://runapi.ai/it/cli.md)
- [MCP Server](https://runapi.ai/it/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md)
- [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/it/contact.md)
- [Contatti](https://runapi.ai/it/contact.md)
- [Termini](https://runapi.ai/it/terms.md)
- [Privacy](https://runapi.ai/it/privacy.md)
- [Indice del sito per gli agenti](https://runapi.ai/llms.txt)

Contatti: contact@runapi.ai

## Dati strutturati

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/iticon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "TechArticle",
    "headline": "Cherry Studio",
    "description": "Connetti Cherry Studio a RunAPI e verifica una chat.",
    "url": "https://runapi.ai/it/docs/resources/application-practices/cherry-studio",
    "mainEntityOfPage": "https://runapi.ai/it/docs/resources/application-practices/cherry-studio"
  }
]
```