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 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.
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. 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:
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.
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.
Entra en la sección de servicios de modelos y busca el botón para añadir un proveedor, situado debajo de la lista.
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.
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 |
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:
https://api.crazyrouter.com
Debajo debe aparecer la ruta de la petición:
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 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.
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 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.
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.
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.
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 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.
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.
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.
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 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.
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.