Añade todos los modelos del catálogo a Cherry Studio como un solo proveedor.

Updated 2026-07-29

La configuración de Model Services de Cherry Studio acepta cualquier endpoint compatible con OpenAI: añade un proveedor de tipo OpenAI, apunta la dirección de la API a api.apisrouter.com, pega una clave y añade los ids de modelo a mano. Claude, GPT, DeepSeek, GLM, Kimi y Qwen conviven en un solo selector en el escritorio.

Respuesta rápida: un proveedor en Model Services.

Haz clic en el icono de engranaje en la navegación izquierda de Cherry Studio, abre la pestaña Model Services y pulsa el botón Add debajo de la lista de proveedores. Dale al proveedor un nombre reconocible (APIsRouter), elige OpenAI como tipo de proveedor y guarda. Ahora selecciona el nuevo proveedor en la lista y configúralo: activa su interruptor de habilitación, pega tu clave en el campo API key y define la dirección de la API como https://api.apisrouter.com. Fíjate en la forma: el comportamiento por defecto documentado de Cherry Studio es tomar la dirección raíz y añadir /v1/chat/completions por su cuenta, así que introduces el host sin /v1. Después añade modelos con el botón Add en la sección de modelos, un id exacto del catálogo por entrada (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), y pulsa el botón Check junto a la clave para ejecutar una validación en vivo contra un modelo seleccionado.

Provider name:  APIsRouter
Provider type:  OpenAI

then, on the provider page:
API key:        sk-YOUR-APISROUTER-KEY
API address:    https://api.apisrouter.com
                (Cherry appends /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pick a model → success

Cómo compone Cherry Studio la URL de la petición.

Cherry Studio (CherryHQ en GitHub, unas 49K estrellas) es un cliente de escritorio de origen chino para Windows, macOS y Linux, conocido por incluir plantillas preconfiguradas para cientos de proveedores y asistentes. Todo lo que no esté en esa lista preconfigurada entra por el flujo de proveedor personalizado descrito arriba, y la parte que vale la pena entender es el campo de dirección de la API. El comportamiento por defecto documentado: tú proporcionas la dirección raíz, y Cherry Studio concatena la ruta de OpenAI sobre ella, así que https://api.apisrouter.com se convierte en https://api.apisrouter.com/v1/chat/completions en la petición real. Si un proveedor usa una ruta no estándar, terminar la dirección con # desactiva la concatenación por completo y la dirección se usa exactamente como se escribió, que es la vía de escape documentada. El comportamiento de concatenación en torno a las barras finales ha cambiado entre versiones, así que si las peticiones devuelven 404, lee la URL final en el error en lugar de adivinar; la forma de dirección raíz más el añadido automático es la configuración estable para un gateway /v1 estándar. Una vez configurado, cada conversación envía chat completions estándar con el id de modelo que añadiste como una simple cadena de texto. El proveedor del modelo no importa para el formato de la petición, y eso es lo que permite que una sola entrada de proveedor combine ids del catálogo chinos y occidentales.

Detalles que merecen la pena: multi-clave y gestión de modelos.

El campo API key acepta más de una clave: separa las claves con comas inglesas y Cherry Studio rota entre ellas de arriba a abajo en cada petición, una función de balanceo de carga documentada. Con un gateway que mide por clave, esto también sirve como atribución: una clave para el trabajo, otra para lo personal, y la rotación se desactiva listando solo una. Las entradas de modelo son manuales, y eso es una ventaja. Cherry Studio muestra exactamente lo que añades, así que el selector se mantiene curado en lugar de ahogarse en un catálogo obtenido automáticamente. Cada entrada toma el id como la cadena que viaja en la petición; el botón Manage edita o elimina entradas más adelante. Agrupa ids relacionados con una nomenclatura consistente y el selector se lee como un menú: nivel rápido (deepseek-v4-flash, claude-haiku-4-5-20251001), fuerza regional (glm-5.2, qwen3.7-plus, kimi-k2.6), vanguardia (claude-sonnet-4-6). El botón Check valida el par de clave y dirección contra un modelo que elijas, y es la forma más rápida de confirmar el proveedor antes de conversaciones reales. Un Check fallido con una clave correcta casi siempre significa que el campo de dirección lleva un /v1 de más que duplicó la ruta.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# add these ids verbatim in the provider's model list

Elegir modelos para el caballo de batalla de tu escritorio.

Una sola clave significa que comparar es solo cambiar de selector. Ejecuta la misma semana de trabajo con dos ids candidatos y deja que el gasto por modelo en la consola de APIsRouter arbitre junto con tu propia lectura de la calidad del resultado.

  • El chat diario y las reescrituras rápidas viven en el nivel rápido: deepseek-v4-flash y claude-haiku-4-5-20251001 hacen que la ventana siempre abierta se sienta gratuita.
  • El trabajo en chino es donde los ids regionales se ganan su fila: glm-5.2 y qwen3.7-plus para redactar documentos, kimi-k2.6 para lectura de contexto largo.
  • claude-sonnet-4-6 se encarga de las conversaciones que reenvías sin editar: análisis cuidadoso, prosa de cara al cliente, código que piensas publicar.
  • Los asistentes de Cherry Studio pueden fijar su propio modelo por rol, así que un asistente de traducción en glm-5.2 y un asistente de programación en claude-sonnet-4-6 conviven detrás de un mismo proveedor.
  • Añade filas con intención; un selector curado de seis modelos se usa, mientras que un catálogo completo pegado solo se recorre con scroll.

Pago por uso · por debajo del precio oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModeloPrecio oficialNuestro precio
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Qwen 3.7 Plus$0.29 / $1.14 per M$0.30 / $1.10 per M

Modos de fallo específicos de Cherry Studio.

La ruta duplicada es el reporte más frecuente: pegar https://api.apisrouter.com/v1 en un campo que ya añade /v1/chat/completions produce URLs /v1/v1 que devuelven 404. Introduce la dirección raíz y deja que el cliente construya la ruta. Si necesitas fijar una URL exacta, existe la forma con # al final para eso. Un Check fallido con una clave correcta suele ser la forma de dirección anterior; un Check fallido con una dirección limpia es la clave, y ten en cuenta que varias claves deben separarse con comas inglesas, ya que los caracteres de ancho completo pegados desde métodos de entrada chinos rompen la lista en silencio. Que algunos modelos den error mientras otros funcionan es un problema de ortografía del id; las entradas son texto libre y el listado de /v1/models es la fuente autorizada. Y recuerda que la configuración es por máquina: un proveedor configurado en tu escritorio no existe en tu portátil hasta que repitas la configuración de dos minutos o uses las propias funciones de copia de seguridad de Cherry Studio. Nota sobre deriva de versiones: Cherry Studio publica versiones con frecuencia y las etiquetas de configuración se mueven (Model Services también ha aparecido como Model Provider en algunas versiones); el flujo de añadir proveedor, elegir tipo OpenAI, clave, dirección, modelos se ha mantenido estable.

Quién enruta Cherry Studio a través de un gateway.

  • Usuarios de escritorio bilingües que combinan GLM, Qwen, Kimi y DeepSeek con Claude y GPT en un solo selector, un solo saldo, sin cuentas por proveedor.
  • Usuarios en Asia que quieren ids de Claude y GPT con un saldo prepago sin tarjeta occidental, junto a los modelos regionales que ya usan.
  • Usuarios avanzados que ejecutan asistentes de Cherry Studio por rol y quieren que cada asistente quede fijado al proveedor correcto sin gestionar cinco claves.
  • Personas que ya enrutan otras herramientas a través de un gateway y quieren que el cliente de escritorio use la misma clave y el mismo registro de uso.
  • Cualquiera que compare modelos regionales y occidentales en trabajo real del día a día en lugar de benchmarks, donde cada candidato es una simple fila de modelo.

Verifica el endpoint y depura la primera conversación.

Primero haz curl al listado de modelos y copia los ids que planeas añadir; después ejecuta una chat completion contra el modelo que usarás a diario. Si ambas pasan, todo lo que queda está en la página del proveedor. Dentro de Cherry Studio, ejecuta Check antes de chatear. Los fallos de autenticación son el campo de clave o sus separadores de coma. Los 404 son la forma de la dirección: lee la URL compuesta en el error y cuenta los segmentos /v1. Los errores de «no encontrado» en un modelo concreto son un error de ortografía del id en esa fila. Una vez que las conversaciones fluyen, la consola de APIsRouter muestra el modelo, el recuento de tokens y el gasto por petición. Un cliente de escritorio usado durante toda una jornada laboral genera un flujo constante de peticiones pequeñas, y la vista de uso por clave convierte ese flujo en cifras por modelo y por día, con ids chinos y occidentales en la misma página.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Preguntas frecuentes

¿Cómo añado un proveedor personalizado en Cherry Studio?

Icono de engranaje, pestaña Model Services, Add. Nombra el proveedor, elige el tipo OpenAI, guarda, y luego en su página actívalo, pega tu clave, define la dirección de la API como https://api.apisrouter.com y añade los ids de modelo manualmente. Valida con el botón Check.

¿Debe la dirección de la API incluir /v1?

No. El comportamiento por defecto documentado de Cherry Studio toma la dirección raíz y añade /v1/chat/completions por su cuenta, así que introduce https://api.apisrouter.com. Pegar un host con /v1 duplica la ruta y da 404. Para fijar una URL exacta no estándar, termina la dirección con # para desactivar la concatenación.

¿Puede Cherry Studio ejecutar Claude, DeepSeek y GLM a través de un solo proveedor?

Sí. El id de cada fila de modelo viaja hacia la dirección como una simple cadena de texto, así que claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6 y qwen3.7-plus pueden compartir una sola entrada de proveedor y una sola clave, intercambiables por conversación y por asistente.

¿Qué hace la función de claves separadas por comas?

Varias claves en el campo API key, separadas por comas inglesas, se rotan de arriba a abajo entre peticiones, una función de balanceo de carga incorporada. Con medición por clave en el lado del gateway, también funciona como atribución; lista una sola clave para mantener la rotación desactivada.

¿Por qué falla el botón Check?

Con una clave correcta, la causa habitual es una dirección que lleva un /v1 de más que duplica la ruta compuesta. Con una dirección limpia, revisa de nuevo la clave y sus separadores; las comas de ancho completo de métodos de entrada chinos rompen en silencio las listas de varias claves.

¿Por qué los modelos no se autocompletan como en los proveedores preconfigurados?

Los proveedores personalizados listan exactamente lo que añades; Cherry Studio no obtiene el catálogo de un endpoint personalizado automáticamente. Eso mantiene el selector curado. Extrae los ids del listado de /v1/models y añade los que realmente usas, y amplía la lista el día que necesites otro.