# Cherry Studio en Windows: conecta tu API y comprueba qué modelo está respondiendo

**URL:** <https://www.yodev.dev/t/cherry-studio-en-windows-conecta-tu-api-y-comprueba-que-modelo-esta-respondiendo/5823>\
**Category:** Community\
**Tags:** llm\
**Created:** [30 Octubre, 2026 10:04 UTC](https://www.yodev.dev/t/cherry-studio-en-windows-conecta-tu-api-y-comprueba-que-modelo-esta-respondiendo/5823 "2026-10-30T10:04:30Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![xiaoying\_zhou](https://yyz1.discourse-cdn.com/flex009/user_avatar/www.yodev.dev/xiaoying_zhou/32/2522_2.png) [@xiaoying\_zhou](https://www.yodev.dev/u/xiaoying_zhou)\
**Post date:** [30 Octubre, 2026 10:04 UTC](https://www.yodev.dev/t/cherry-studio-en-windows-conecta-tu-api-y-comprueba-que-modelo-esta-respondiendo/5823/1 "2026-10-30T10:04:31Z")

</div>

Cuando configuro una aplicación para usar una API, quiero poder relacionar cada ajuste con lo que hará después: la dirección indica el destino, la clave permite acceder al servicio y el modelo determina qué opción recibirá la tarea. Tener clara esa relación ayuda tanto al empezar como al corregir un error.

En esta guía voy a recorrer la instalación de Cherry Studio y la conexión de un proveedor compatible con OpenAI. Lo haremos desde la interfaz, sin preparar un proyecto ni escribir código para enviar peticiones. Al final propongo un ejercicio breve con reglas que puedes comprobar por tu cuenta.

Cherry Studio es una herramienta con cierta trayectoria dentro de los clientes de escritorio para IA. Su [repositorio oficial](https://github.com/CherryHQ/cherry-studio) se creó en mayo de 2024, por lo que acumula más de dos años de desarrollo a fecha de este artículo. Permite conversar con distintos modelos y ofrece otras funciones, como agentes y bases de conocimiento.

**A 30 de octubre de 2026, la versión estable más reciente es la v2.1.8, publicada el 26 de octubre de 2026.** Esa versión actual sirve como referencia para esta guía. Puedes consultar sus archivos en la [publicación oficial de la versión](https://github.com/CherryHQ/cherry-studio/releases/tag/v2.1.8).

Las capturas mantienen la interfaz original en chino; explico los controles en español junto a cada imagen. No incluyen una pantalla con el número de versión, de modo que la referencia a v2.1.8 procede de la publicación oficial y no de identificar la versión por su aspecto.

## **Preparar el cliente y el acceso al servicio**

Primero descarga el programa desde la [página oficial de Cherry Studio](https://cherryai.com.cn/download/v2). Para un PC Windows habitual con Intel o AMD, elige x64. Si utilizas Windows en un equipo ARM, elige ARM64. Puedes comprobar el tipo de sistema en Configuración → Sistema → Acerca de, dentro de Windows.

El instalador x64 de la versión de referencia se llama:

```auto
Cherry-Studio-2.1.8-win-x64-setup.exe

```

Ejecuta el archivo, sigue el asistente y abre Cherry Studio. Para este recorrido uso el paquete que contiene `setup` en el nombre; `portable` identifica la alternativa portátil. Si lees esto más adelante, comprueba la versión en la [última publicación oficial de GitHub](https://github.com/CherryHQ/cherry-studio/releases/latest).

También necesitas **una clave API**. Puede ser la API oficial del fabricante de un modelo o un servicio compatible que ya utilices. Yo suelo usar Crazyrouter, así que lo tomaré como ejemplo. Si prefieres otro proveedor, utiliza su clave, su dirección y el formato de API que indique.

Cherry Studio proporciona la interfaz. El proveedor conectado gestiona el acceso a los modelos y registra el uso de su API. Instalar la aplicación no concede por sí solo acceso a todos los modelos que puedan aparecer en un catálogo.

## **Crear una conexión reconocible**

En Cherry Studio, abre los ajustes con el engranaje de la esquina inferior izquierda.

 ![El engranaje de la esquina inferior izquierda abre los ajustes de Cherry Studio.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/a/a8938767ada592843a4d3f0bbf73badfde8de597.png)

Entra en la sección de servicios de modelos y busca el botón para añadir un proveedor, situado debajo de la lista.

 ![La sección de servicios de modelos muestra los proveedores y el botón para añadir uno nuevo.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/3/3a6f4a8166e04893085c10f93258f4f7c3e14ee7.png)

Si todavía no tienes la clave, en el panel de Crazyrouter abre **API Keys** y pulsa **Create API Key**. Antes necesitarás una cuenta del servicio elegido. Un nombre como `cherry-studio` ayuda a reconocer el uso previsto de esa clave.

 ![La sección API Keys del panel permite crear una clave; su contenido está oculto en la captura.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/e/e504d75b8e202689132f2590ba3c116b4b257e72.png)

Copia la clave completa con el control de copia. La versión abreviada con asteriscos no sirve como credencial, y la contraseña de tu cuenta tampoco corresponde a este campo. Si compartes capturas de tu configuración, oculta toda la clave.

En el diálogo de proveedor personalizado, completa estos datos:

| **Campo** | **Valor en este ejemplo** |
| --- | --- |
| Nombre del proveedor | `Crazyrouter` |
| Clave API | La clave completa del panel |
| Dirección del endpoint OpenAI | `https://api.crazyrouter.com` |

 ![El diálogo de proveedor personalizado reúne el nombre, la clave y las direcciones de los endpoints.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/e/e2d237510278a8bb1fe0a0c3fd5665b6e65008d2.png)

OpenAI identifica aquí el formato compatible de la API. Para conectarte a Crazyrouter debes conservar una clave de Crazyrouter. También aparece un endpoint Anthropic, pero en este tutorial utilizamos el formato compatible con OpenAI para una conversación normal.

### **Comprobar la ruta que construye Cherry Studio**

En este campo introducimos la dirección raíz:

```auto
https://api.crazyrouter.com

```

Debajo debe aparecer la ruta de la petición:

```auto
https://api.crazyrouter.com/v1/chat/completions

```

En esta configuración el cliente añade la ruta estándar. Si pegas una dirección completa en un campo que ya añade esa parte, puedes terminar con una URL incorrecta. Revisa especialmente que no se repita `/v1`.

La [documentación de integración con Cherry Studio](https://docs.crazyrouter.com/en/integrations/cherry-studio) describe esta forma de introducir la dirección. No conviene trasladar la regla a cualquier SDK o proveedor: para otra conexión, consulta sus instrucciones y la ruta que genera el cliente.

Cuando los datos estén completos, añade el proveedor.

## **Añadir los modelos y decidir si quieres una comprobación aparte**

La lista de la captura contiene **168 modelos**. Marca los que quieras y pulsa el botón de añadir los modelos seleccionados, abajo a la derecha. Si ya están en esa lista, no necesitas escribir sus identificadores uno a uno.

 ![La lista capturada contiene 168 modelos y permite seleccionar directamente las opciones mediante casillas.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/6/675675135d91b7a94b05d99ecdcd5e84c65adefb.png)

Puedes buscar por nombre o filtrar por tipo de tarea. El número 168 corresponde a esta captura; el catálogo puede cambiar. Para empezar con texto, el [catálogo de modelos de conversación](https://crazyrouter.com/en/models/task/chat) permite revisar opciones, aunque debes elegir una a la que tu clave tenga acceso.

La siguiente ventana muestra completadas la incorporación de modelos, la validación y la activación del proveedor. Si aparece durante el proceso, pulsa el botón de finalizar.

 ![La ventana final muestra las marcas de incorporación de modelos, validación y activación del proveedor.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/9/9983af9ddbb247a122d4323b5596df4ffdd609bd.png)

En la página del proveedor también hay una comprobación de conexión independiente. Permite seleccionar un modelo y empezar la comprobación.

 ![El diálogo de comprobación independiente permite elegir el modelo que se va a consultar.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/2/2bbfbe1bbc49a929c616bae39de9e8b423a02fef.png)

**Esta comprobación manual adicional es opcional. Realiza llamadas a la API y genera cargos de uso según las reglas de facturación del proveedor.** Comprobar todos los modelos puede implicar varias llamadas.

Puedes revisar uno si necesitas diagnosticar la conexión. También puedes ir directamente al chat tras añadir los modelos y activar el proveedor. Enviar un mensaje normal utiliza igualmente la API.

## **Separar los ajustes guardados de la selección del chat**

Los ajustes de modelos predeterminados sirven para asignar distintos trabajos. El modelo predeterminado del asistente se utiliza cuando el asistente no tiene otro modelo asignado.

 ![Los modelos predeterminados distinguen el asistente, las tareas rápidas, la traducción y la generación de imágenes.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/c/c632e4f505b9de641d03192a757a940a28cdf950.png)

El modelo rápido interviene en tareas como nombrar conversaciones y extraer palabras para búsquedas. Los de traducción e imágenes corresponden a sus respectivas funciones. La [documentación oficial de modelos predeterminados](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/default-models) explica estas diferencias. No hace falta cambiar todas las opciones para enviar el primer mensaje.

Para elegir el modelo de una conversación, abre el chat y pulsa su nombre en la parte superior. Busca Crazyrouter y selecciona el modelo que acabas de añadir.

 ![El selector de la conversación permite escoger un modelo dentro del proveedor configurado.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/c/c42a675bc0d745a5148a108c66495610c7ed476a.png)

Este es el lugar que revisaría antes de enviar la tarea. Que un modelo esté guardado, o que otro haya superado una comprobación, no confirma qué opción está seleccionada en la conversación actual.

## **Una primera tarea con condiciones fáciles de revisar**

Para comprobar una respuesta sin depender de una búsqueda externa, propongo transformar una regla de importación en una tabla de casos. **Es un ejercicio preparado para que lo pruebes; no representa una prueba de API ejecutada para este artículo.**

```auto
Evalúa estos archivos ficticios según las reglas de importación:
- Solo se admite la extensión .csv, sin distinguir mayúsculas.
- Se permiten de 1 a 100 filas de datos, ambos límites incluidos.
- La cantidad indicada ya excluye la cabecera.
​
Archivos:
A.csv: 100 filas
B.csv: 101 filas
C.txt: 20 filas
D.CSV: 30 filas
E.csv: 0 filas
​
Devuelve una tabla con archivo, aceptado o rechazado, y motivo.
Aplica únicamente estas reglas. No inventes el contenido de los archivos.
Después indica cuántos se aceptan y cuántos se rechazan.

```

La referencia se obtiene de las condiciones: A y D se aceptan; B supera el máximo, C tiene otra extensión y E no alcanza el mínimo. En total son dos aceptados y tres rechazados. Esta es una solución de control deducida del enunciado, no una salida registrada de un modelo.

Conviene mirar los límites: 100 está permitido, 0 no, y `.CSV` debe tratarse igual que `.csv`. Una respuesta puede presentar una tabla impecable y aun así interpretar mal uno de esos puntos.

Si recibes un error antes de obtener texto, empieza por el ajuste asociado:

| **Síntoma** | **Qué revisar** |
| --- | --- |
| Error de autenticación, como 401 | Clave completa, validez y espacios añadidos al copiar |
| Error de ruta o 404 | Endpoint, formato de API y ruta generada |
| Modelo rechazado | Disponibilidad del modelo y permisos de la clave |
| Modelo ausente en el chat | Confirmación de su incorporación y proveedor activado |
| Comprobación correcta, conversación fallida | Si has seleccionado el mismo modelo en ambos sitios |

Son puntos de partida para investigar, no diagnósticos universales para cada código. Cambia una cosa cada vez para poder relacionar el resultado con la modificación.

## **Añadir búsqueda y herramientas cuando la tarea lo necesite**

El ejercicio anterior solo requiere texto. Si más adelante necesitas consultar información de la web, distingue la búsqueda de la posibilidad de controlar un navegador. La captura siguiente corresponde a los permisos de control del navegador.

 ![El permiso para manejar el navegador es una opción diferente del servicio de búsqueda web.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/a/a08f6d5b7c9ec98e37995634d3df68605ac813cb.png)

Para buscar información antes de responder, revisa el servicio en los ajustes de búsqueda web y activa la búsqueda desde el área de entrada del chat. Comprueba la actividad de búsqueda y las fuentes de esa respuesta para saber si se ha utilizado. La [guía oficial de búsqueda web](https://docs.cherryai.com.cn/docs/en-us/pre-basic/settings/websearch) detalla estas opciones. Una conversación de texto normal no necesita permiso para controlar el navegador.

Otros apartados permiten configurar MCP, habilidades, procesamiento de documentos, OCR y el asistente rápido.

 ![Más apartados de configuración de Cherry Studio, incluidos herramientas y procesamiento de documentos.](https://canada1.discourse-cdn.com/flex009/uploads/inovacon/original/2X/3/3a36700022b4c96680ee5e1a0d8c512baa286752.png)

Yo los incorporaría cuando una tarea concreta los requiera. Para empezar, saber qué servicio recibe la petición, qué modelo está seleccionado y cómo comprobar la respuesta ya permite trabajar con una configuración comprensible.

Si necesitas instalar o actualizar el cliente, utiliza la [descarga oficial de Cherry Studio](https://cherryai.com.cn/download/v2).