Configuración de la API de Cherry Studio: añadir un proveedor personalizado, dirección y modelos

Para configurar su propia API en Cherry Studio, la ruta es 設定 → 模型供應商 → 新增供應商: introduzca la clave de API, rellene una dirección raíz en cada uno de los campos OpenAI y Anthropic de «端點設定», guarde, pulse «同步模型» para importar los modelos y después use «檢查» para verificar que funciona.Este artículo se basa en la versión v2.1.4 publicada el 30 de septiembre de 2026, y todos los nombres de los menús reproducen el texto original de la interfaz de Cherry Studio en chino tradicional. La versión v2 modificó considerablemente la pantalla para añadir proveedores; los tutoriales de la era v1 que indicaban «seleccionar OpenAI como tipo» ya no coinciden.

Esta página se refiere a la versión de escritorio de CherryHQ/cherry-studio (AGPL-3.0, compatible con Windows, macOS y Linux). Al comprobarlo el 1 de octubre de 2026, el repositorio no estaba archivado y la versión más reciente era la v2.1.4. La aplicación con el mismo nombre de la App Store es un producto no relacionado de otro desarrollador. Además, la documentación oficial de Cherry Studio está en chino simplificado; al cambiar la interfaz al chino tradicional, «提供商/服務商» aparece como «供應商». No deje que las diferencias de nombres le confundan al consultar la documentación.

Configuración paso a paso

設定 → 模型供應商 → 新增供應商
  （對話框標題：新增自訂供應商）

  供應商名稱                 Kunavo
  API 金鑰                   sk-kn-...
  端點設定
    OpenAI Chat Completions  https://api.kunavo.com/v1
    Anthropic Messages       https://api.kunavo.com
  更多選項
    OpenAI Responses         https://api.kunavo.com/v1   （選填）
    影像產生基礎 URL           https://api.kunavo.com/v1   （選填）
    Google Gemini            留空

→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」

1. Abra Configuración → Proveedores de modelos y pulse Añadir proveedor. El cuadro de diálogo que aparece se titula «Añadir proveedor personalizado». Para servicios del tipo Coding Plan, varias cuentas o separación por proyecto, puede usar «Comenzar desde un valor predeterminado (opcional)» en la parte superior para crear uno a partir de un valor predeterminado existente.
2. Rellene Nombre del proveedor y Clave de API.
3. La Configuración de endpoints ya incluye de forma predeterminada los campos OpenAI Chat Completions y Anthropic Messages; debe configurar al menos un endpoint de texto. Si rellena ambos, podrá seleccionar modelos para agentes distintos del chat y para funciones que utilizan el formato de Anthropic.
4. Expanda Más opciones; también encontrará OpenAI Responses, Google Gemini, URL base de generación de imágenes y URL base de edición de imágenes. Puede dejar vacíos los que no utilice.
5. Después de guardar, confirme que este proveedor esté en estado Habilitado. La documentación oficial indica que los proveedores configurados pero no habilitados no muestran sus modelos en el menú; esta es la causa más común de que «la clave no responda».
6. En la lista de modelos, pulse Sincronizar modelos, añada los modelos que quiera usar y después pulse Comprobar para probar uno.

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

Según el código fuente de v2.1.4, cada campo debe contener una dirección raíz: cuando no incluye un segmento de versión, se añade automáticamente /v1 (y no se añade si ya está presente), seguido de la ruta fija de ese campo. Debajo de cada campo aparece «Ruta de solicitud», que es la URL final enviada.

Dos errores habituales: primero, pegar una URL completa que incluya /chat/completions o /messages, lo que duplica la ruta y devuelve 404; segundo, añadir # al final. El aviso de la interfaz lo explica claramente: «Añada # al final para desactivar la adición automática de la versión de la API». En un endpoint estándar, añadirlo hace que desaparezca /v1.

Configúrelo bien y reduzca la factura

Además del chat, Cherry Studio llama a modelos en segundo plano. Según la descripción de la interfaz, el modelo rápido se «utiliza para tareas sencillas como nombrar conversaciones y extraer palabras clave de búsqueda», y el aviso indica «seleccione un modelo ligero y evite usar modelos de razonamiento». Si coloca aquí un modelo barato, no hará que el modelo caro se ejecute una vez en cada conversación. El modelo de traducción también se configura por separado. Si selecciona varios modelos para preguntarles simultáneamente, se envía una solicitud a cada modelo y cada una se cobra por separado. El importe que muestra la estadística de uso de la aplicación es un valor estimado calculado según los precios públicos; al utilizar una ruta con descuento, será superior al real. Cambie el precio unitario en la configuración del modelo por su precio efectivo para obtener una cifra precisa. Consulte Cherry Studio API cost en inglés para más detalles.

Notas sobre el uso de Kunavo y los pagos en Taiwán

• Alcance de la verificación: La configuración anterior se recopiló a partir del código fuente y la documentación oficial de Cherry Studio; Kunavo no ha conectado Cherry Studio a sus propios endpoints ni lo ha ejecutado. Conserve la ruta que ya funciona y pruebe esta otra.
• Solo chat e imágenes: Kunavo no tiene modelos de embeddings; la recuperación vectorial de la base de conocimientos debe usar otro proveedor o un modelo de embeddings local. La documentación oficial indica que, sin un modelo de embeddings, la base de conocimientos sigue funcionando mediante recuperación de palabras clave BM25.
• Herramientas MCP: Las herramientas añadidas en Configuración → Servidores MCP solo pueden ser invocadas por modelos compatibles con llamadas a herramientas; los modelos Claude y GPT añadidos arriba son compatibles.
• Pago: saldo prepago, cobro por token y sin cuota mensual. Recarga mínima de $10, checkout mediante Stripe; en Taiwán se pueden usar tarjetas de crédito (Visa, Mastercard, American Express, JCB y UnionPay), Apple Pay, Google Pay y Link. JkoPay y LINE Pay no están incluidos en la lista de métodos disponibles. Consulta la documentación de facturación; cuando estés listo, puedes crear una cuenta y generar una clave. La página de configuración en inglés es la guía de integración de Cherry Studio.

Preguntas frecuentes

Verificado el 1 de octubre de 2026: la API de GitHub (CherryHQ/cherry-studio, v2.1.4), las cadenas de la interfaz en chino tradicional de v2.1.4 (zh-tw.json), el código fuente de la pantalla para añadir proveedores y la documentación oficial de Cherry Studio. Kunavo no ha ejecutado sus propios endpoints con Cherry Studio.