Configuración de la API de Cherry Studio: proveedor personalizado, dirección y modelo

La ruta para configurar la API en Cherry Studio es Settings → Model Provider → Add Provider. Introduce API Key, escribe la dirección raíz en los campos OpenAI y Anthropic de Endpoint settings, guarda, importa los modelos con ‘Sync models’ y comprueba uno con ‘Check’. Lo primero que debes saber: Cherry Studio no tiene interfaz en coreano, por lo que los menús aparecen tal cual en inglés. Esta página se basa en v2.1.4, publicada el 30 de septiembre de 2026. Como la pantalla para añadir proveedores cambió considerablemente en v2, las instrucciones de la época de v1 con ‘Type: OpenAI’ ya no coinciden con la interfaz.

El objetivo es la versión de escritorio de CherryHQ/cherry-studio (AGPL-3.0, Windows, macOS y Linux). A 1 de octubre de 2026, el repositorio no está archivado y la versión más reciente es v2.1.4. La aplicación del mismo nombre de la App Store es una aplicación no relacionada de otro desarrollador. La interfaz integrada tiene 13 idiomas y no incluye coreano (según los archivos de traducción de la interfaz de v2.1.4), por lo que estas instrucciones presuponen la interfaz en inglés.

Configuración paso a paso

Settings → Model Provider → Add Provider
  (대화상자 제목: Add Custom Provider)

  Provider Name       Kunavo
  API Key             sk-kn-...
  Endpoint settings
    OpenAI            https://api.kunavo.com/v1
    Anthropic         https://api.kunavo.com
  More options
    OpenAI Responses            https://api.kunavo.com/v1   (선택)
    Image Generation Base URL   https://api.kunavo.com/v1   (선택)
    Gemini                      비워 둠

→ Save → 모델 목록에서 "Sync models" → 쓸 모델 추가 → "Check"

1. En Settings → Model Provider, pulsa Add Provider. El título del cuadro de diálogo que se abre es ‘Add Custom Provider’. Si necesitas servicios de la categoría Coding Plan, varias cuentas o separar proyectos, también puedes empezar desde un preset existente mediante ‘Start from a preset (optional)’ en la parte superior.
2. Introduce Provider Name y API Key.
3. Endpoint settings incluye desde el principio dos campos: OpenAI y Anthropic. Se necesita al menos un endpoint de texto (si lo dejas vacío aparece el error ‘Configure at least one text endpoint’). Si completas ambos campos, podrás elegir modelos no solo para el chat, sino también para Agent y para funciones que utilizan el formato de Anthropic.
4. Al desplegar More options, aparecen los campos OpenAI Responses, Gemini, Image Generation Base URL e Image Edit Base URL. Deja vacíos los campos que no uses.
5. Después de guardar, comprueba que el proveedor esté activado (Enable). Según la documentación oficial, los proveedores configurados pero no activados no aparecen en la lista de selección de modelos. Es la causa más común de que ‘la clave no funcione’.
6. Importa los modelos con Sync models desde la lista de modelos, añade el que quieras usar y comprueba uno con Check.

Cómo escribir la dirección: solo la raíz

Según el código fuente de v2.1.4, en cada campo debes introducir la dirección raíz. Si falta la parte de la versión, se añade automáticamente /v1 (si ya está, no se añade), y después se agrega la ruta fija correspondiente al campo. Debajo de cada campo aparece la URL final en ‘Request path’; compruébala antes de guardar.

Hay dos errores comunes. Si pegas una URL completa que ya incluye /chat/completions o /messages, la ruta se añade dos veces y produce un 404. Además, el # final es el símbolo que, según la indicación de la interfaz, significa ‘Add # at the end to disable the automatically appended API version’, es decir, desactiva la adición automática de la versión; si lo añades a un endpoint estándar, falta /v1. Para comprobar rápidamente la dirección y la clave, el siguiente comando es lo más eficaz.

curl https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer $KUNAVO_API_KEY"

Configuración del modelo básico para ahorrar costes

Cherry Studio llama a modelos en segundo plano, además del chat. Quick Model se utiliza, según la descripción de la interfaz, para ‘tareas sencillas como poner nombre a las conversaciones y extraer palabras clave de búsqueda’, y las instrucciones también dicen ‘elige un modelo ligero y evita los modelos de razonamiento’. Si configuras aquí un modelo barato, no se ejecutará un modelo caro cada vez que chatees. Configura también Translate Model por separado. Si eliges varios modelos y les haces una pregunta a la vez, se envía una solicitud independiente por modelo y se cobra por separado. El importe de las estadísticas de uso de la aplicación es una estimación convertida a partir de precios públicos, por lo que en rutas con descuento aparecerá más alto que el importe real. Cambia el precio unitario en la configuración del modelo al coste real para corregirlo. Consulta la página en inglés Cherry Studio API cost para obtener más información.

Aspectos importantes y pagos al usar Kunavo

• Alcance de la verificación: Esta configuración se ha redactado consultando el código fuente y la documentación oficial de Cherry Studio; no se ha verificado ejecutando Cherry Studio conectado a los endpoints propios de Kunavo. Mantén la ruta que utilizas actualmente y pruébala.
• Solo chat e imágenes: Kunavo no tiene modelos de embeddings, por lo que la búsqueda vectorial de una base de conocimiento requiere otro proveedor o un modelo local de embeddings. La documentación oficial explica que la base de conocimiento funciona mediante búsqueda de palabras clave BM25 incluso sin un modelo de embeddings.
• Herramientas MCP: Las herramientas añadidas en Settings → MCP Servers requieren un modelo compatible con llamadas a herramientas. Los modelos Claude y GPT añadidos anteriormente son compatibles.
• Pago: es una recarga prepaga sin cuota mensual; el saldo se descuenta por token. La recarga mínima es de $10. En el checkout de Stripe puedes usar tarjetas (Visa, Mastercard, American Express, JCB y UnionPay), Apple Pay, Google Pay y Link. Si el checkout aparece en wones, también se ofrecen KakaoPay, Naver Pay, PAYCO, Samsung Pay y tarjetas nacionales que bloquean los pagos internacionales (añadido el 2026-10-03; aún no se ha realizado ningún pago con estos métodos). Los importes se fijan en dólares y Stripe convierte la visualización a wones; el tipo de cambio incluye una comisión de conversión del 2–4 % a cargo del pagador. Toss Pay no está disponible. Consulta la guía de pagos, crea una cuenta y genera una clave. La página de configuración en inglés es la guía de integración de Cherry Studio.

Preguntas frecuentes

Comprobado el 1 de octubre de 2026: API de GitHub (CherryHQ/cherry-studio, v2.1.4), lista de archivos de traducción de la interfaz de v2.1.4 y cadenas de la interfaz en inglés (en-us.json), código fuente de la pantalla para añadir proveedores y documentación oficial de Cherry Studio. Kunavo no ha ejecutado Cherry Studio con sus propios endpoints.