Cherry Studio: usa Claude y GPT con una API personalizada

Cherry Studio es un cliente de IA de escritorio gratuito para Windows, macOS y Linux. Ofrece una ventana de chat con asistentes, selector de modelos, bases de conocimiento, herramientas MCP y respuestas de varios modelos en paralelo. Cherry Studio no trae modelos propios: conectas proveedores con claves de API y cada mensaje lo factura ese proveedor.

APIVAI es uno de esos proveedores. Una sola clave de APIVAI funciona con modelos Claude y GPT, en formato OpenAI y en formato Anthropic, con pago por token por debajo de los precios oficiales. Así, una única entrada de proveedor en Cherry Studio te da Claude Sonnet 4.6, Claude Opus 5.5 y GPT-5.5 en la misma lista de modelos.

Cherry Studio ofrece dos formas claras de conectar APIVAI:

Elige el proveedor personalizado si quieres Claude y GPT juntos con una clave; es lo que conviene a la mayoría. Elige el proveedor Anthropic si solo usas Claude y prefieres el formato nativo, por ejemplo para funciones de Cherry Studio que necesitan un endpoint con protocolo Anthropic. Puedes configurar ambos con la misma clave.

En las versiones actuales, el diálogo + Add Provider muestra campos de endpoint separados (OpenAI y Anthropic por defecto, y más en More Settings). La documentación de Cherry Studio no explica cómo elige un modelo entre dos endpoints del mismo proveedor, así que esta guía solo rellena ahí el endpoint OpenAI y usa el proveedor Anthropic integrado para la vía nativa de Claude. Las versiones antiguas piden un Provider Type; elige OpenAI.

1. Regístrate en apivai.com con tu correo.
2. Recarga saldo desde $10 con tarjeta, cripto, Alipay o WeChat Pay. No hay suscripción ni prueba gratuita; solo pagas los tokens que usas.
3. Abre el Panel, crea una clave y cópiala. Puedes asignarle su propio límite de presupuesto.

1. Haz clic en Settings (el icono de engranaje de la barra lateral izquierda).
2. Abre la pestaña Model Services.
3. Haz clic en + Add Provider, debajo de la lista de proveedores.
4. Rellena el diálogo según la tabla y haz clic en Add.

Sobre /v1: Cherry Studio espera la dirección base y añade la versión y la ruta por su cuenta, de modo que https://api.apivai.com se convierte en https://api.apivai.com/v1/chat/completions. Las versiones actuales también aceptan https://api.apivai.com/v1 sin duplicarlo, pero nunca pegues la dirección completa con /v1/chat/completions. Un # al final indica a Cherry Studio que use la dirección tal cual; con APIVAI no hace falta.

1. Abre en la lista el proveedor APIVAI que acabas de crear.
2. Haz clic en Get model list. Cherry Studio obtiene los modelos que tu clave puede usar; pulsa el + junto a cada uno que quieras. Solo los modelos añadidos aparecen en los selectores.
3. Si prefieres escribirlos, haz clic en + e introduce un ID como claude-sonnet-4-6, claude-haiku-4-5 o gpt-5.5.

La lista de modelos cambia con el tiempo, así que toma los IDs de Get model list o de la página de precios, no de capturas antiguas.

1. Haz clic en Test (Check en algunas versiones) y elige un modelo. Un mensaje de éxito indica que la clave y la dirección son correctas.
2. Activa el proveedor con el interruptor de la esquina superior derecha de su página. Un proveedor activo muestra un punto verde en la lista.
3. Abre un chat, elige el modelo en el desplegable superior y envía un mensaje.

En Model Services, abre Anthropic, pega tu clave de APIVAI en API Key y cambia API Address de https://api.anthropic.com a https://api.apivai.com. No añadas /v1; la dirección tiene la misma forma que la de Anthropic. Después haz clic en Get model list, añade los modelos Claude que quieras y activa el proveedor. Los modelos GPT no funcionan aquí; usan el proveedor personalizado del paso 2. La página Claude API proxy explica el formato Anthropic con más detalle.

Precios por 1M de tokens a fecha de 2026-10-07. Todos los modelos están en la página de precios.

Un esquema práctico: un asistente por defecto barato con Claude Haiku 4.5 o GPT-6 Luna, uno principal con Claude Sonnet 4.6 y Claude Opus 5.5 solo para las preguntas que lo necesiten. Cherry Studio permite enviar una pregunta a varios modelos a la vez, una forma barata de compararlos con tus propias tareas.

Cherry Studio es gratuito; solo pagas los tokens. Cada mensaje reenvía la conversación anterior, así que en chats largos cada turno cuesta más. El razonamiento (thinking) está activado por defecto y sus tokens se facturan como salida.

• Chat diario: supón un turno de unos 3.000 tokens de entrada (tu mensaje más el historial reciente) y 800 de salida. Con Claude Sonnet 4.6 un turno cuesta $0.0073 ($0.021 a precios oficiales). Con 40 turnos al día durante 30 días (1.200 turnos) son $8.76 al mes, frente a $25.20. El mismo mes cuesta $2.93 con Claude Haiku 4.5 y $0.126 con GPT-6 Luna.
• Trabajo con un documento largo: pegas un informe de unos 30.000 tokens y haces 10 preguntas de seguimiento; cada una reenvía unos 31.000 tokens de entrada y devuelve 1.500 de salida. Con Claude Sonnet 4.6 la sesión cuesta $0.401 ($1.16 a precios oficiales).

Para gastar menos, abre un tema nuevo cuando cambies de asunto y dale a Cherry Studio su propia clave con límite de presupuesto. El Panel muestra cada solicitud con sus tokens y su coste. Para una comparación de precios más amplia, consulta Precios de la API de Claude comparados.

El chat funciona por completo a través de APIVAI, pero las bases de conocimiento necesitan un modelo de embeddings para indexar tus archivos, y APIVAI no ofrece embeddings. Para usar una base de conocimiento, configura en Cherry Studio un proveedor de embeddings aparte; el asistente que responde puede seguir siendo un modelo Claude o GPT de APIVAI. Tampoco hay modelos de generación de imágenes en APIVAI.

• 401 o "invalid API key": la clave se copió incompleta, se eliminó o alcanzó su límite de presupuesto. Cópiala de nuevo desde el Panel y revisa tu saldo.
• 404: la dirección es incorrecta. Para el proveedor personalizado usa https://api.apivai.com, sin /chat/completions y sin # al final. Para el proveedor Anthropic usa https://api.apivai.com sin /v1.
• Modelo no encontrado: el ID debe coincidir exactamente, por ejemplo claude-sonnet-4-6, no un nombre visible. Con Get model list ves lo que tu clave puede usar. Los modelos GPT fallan en el proveedor Anthropic; añádelos al proveedor personalizado.
• El modelo no aparece en el selector del chat: el proveedor está desactivado, o cargaste la lista pero no pulsaste + junto al modelo.
• Respuestas vacías o cortadas: los tokens de razonamiento cuentan para el límite de salida. En Edit Assistant → pestaña Model, desactiva Enable message length limit (MaxToken) o ponlo en 4096 o más.
• La respuesta llega de golpe o el streaming se corta: revisa el interruptor Streaming output (Stream) en la misma pestaña y la configuración de proxy en las opciones de red de Cherry Studio.
• 429: el límite por defecto es de 60 solicitudes por minuto por clave. Comparar varios modelos a la vez consume varias solicitudes; espera un momento o pide a soporte un límite mayor.

La documentación recoge todos los endpoints y códigos de error.

Para usar Claude y GPT juntos, un proveedor personalizado con el endpoint OpenAI. El proveedor Anthropic integrado solo si quieres Claude en el formato nativo de Anthropic.

No hace falta. Introduce https://api.apivai.com; Cherry Studio añade /v1 y la ruta de la solicitud. Nunca introduzcas la dirección completa con /v1/chat/completions.

Sí. Una clave de APIVAI sirve para todos los modelos de la página de precios y en ambos formatos. La misma clave funciona en Chatbox y en otras herramientas compatibles con OpenAI.

No. El contenido de solicitudes y respuestas no se registra; solo se conservan datos de uso como el modelo, los tokens y el coste para la facturación. Tu historial se queda en Cherry Studio, en tu ordenador.

No. El pago es prepago y por uso, con recargas desde $10 y sin suscripción.

Crea una cuenta, recarga desde $10 y pega tu clave en Cherry Studio.