Cherry Studio

Settings → Model Services → un proveedor personalizado: pega la clave y la dirección API, haz clic en Get Model List y todo el catálogo aparecerá en el selector.

设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)

  提供商名称 / Provider name    Kunavo
  API 密钥 / API Key            sk-kn-...
  端点设置 / Endpoint settings
    OpenAI                     https://api.kunavo.com/v1
    Anthropic                  https://api.kunavo.com
  → 同步模型 (Sync Models), then add the models you want
  → 检测 (Test) to confirm

Paso a paso

1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
2. Abre 设置 → 模型服务 (Ajustes → Servicios de modelos) y 添加自定义提供商 (Añadir proveedor personalizado).
3. Rellena API 密钥 (la clave) y el campo del endpoint OpenAI (https://api.kunavo.com/v1).
4. Rellena también el campo Anthropic (https://api.kunavo.com): está debajo de OpenAI en 端点设置 (Configuración de endpoints). Cherry Agent y cualquier modelo enrutado mediante el protocolo Anthropic Messages leen específicamente este campo, no el de OpenAI. Los demás tipos de endpoint están en 更多设置 (Más opciones).
5. Guarda, pulsa 同步模型 en la lista de modelos del proveedor y añade los modelos de chat que quieras; pulsa 检测 para verificar uno de principio a fin.
6. Asigna modelos a cada asistente en lugar de hacerlo globalmente: Cherry Studio mantiene un modelo por asistente, lo que permite combinar uno económico como opción predeterminada con otro más caro para tareas especializadas.

Comprobado con Documentación de proveedores de Cherry Studio el 1 de octubre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Cherry Studio.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.