Conecta Cherry Studio a CheapTokens: proveedor personalizado, Base URL

Para usar CheapTokens en Cherry Studio, añade un proveedor personalizado (Ajustes → Proveedor de modelos → Añadir proveedor), coloca https://api.cheaptokens.dev/v1/ en el campo OpenAI Base URL, pega tu clave de API y añade el id del modelo deepseek-ai/DeepSeek-V4-Flash-0731 a mano. Después verifica la clave con Model Check y saluda. Eso es todo; el único detalle que da problemas es la barra al final de la URL.

Abres una app de chat de escritorio porque quieres una sola ventana para varios modelos y un solo saldo detrás de ellos, no una pestaña del navegador por servicio. Cherry Studio está hecho para eso: es una estación de trabajo de IA de código abierto para Windows, macOS y Linux (AGPL-3.0 Community Edition) con chat, agentes y bases de conocimiento, y acepta cualquier servicio compatible con OpenAI como proveedor personalizado. CheapTokens habla el formato OpenAI Chat Completions, así que encaja. Los pasos siguientes siguen la página de documentación de Cherry Studio sobre proveedores personalizados, revisada el 7 de noviembre de 2026; la app en sí cambia, así que si una etiqueta se ha movido, busca la misma palabra cerca.

Lo que necesitas antes de abrir la app#

Tres cosas, todas breves:

• la Base URL: https://api.cheaptokens.dev/v1/ (con la barra final — el motivo está en la siguiente sección);
• una clave de API de tu cuenta de CheapTokens, guardada en algún sitio del que puedas copiarla, no pegada en una nota compartida;
• el id completo del modelo. El nombre corto de la lista de precios no lo acepta la API; usa el id de la pasarela, por ejemplo deepseek-ai/DeepSeek-V4-Flash-0731. Los demás ids están en la guía de list-models y en la documentación de CheapTokens.

Añade el proveedor personalizado#

Abre Ajustes (el icono de engranaje) y luego Proveedor de modelos. Al final de la lista de proveedores está + Add Provider. Haz clic y aparece el diálogo Add Custom Provider.

Rellénalo así:

Cherry Studio muestra por defecto los campos de endpoint 'OpenAI' y 'Anthropic'. Rellena solo el protocolo que uses realmente; para un chat normal es el de OpenAI, y el campo de Anthropic puede quedar vacío. Bajo cada campo Base URL la app muestra una vista previa de la ruta final de la petición. Léela. Es la forma más rápida de detectar una dirección incorrecta antes de enviar nada.

Haz clic en Add para guardar.

Por qué importa la barra final#

Cherry Studio construye la URL de la petición a partir de tu Base URL con tres reglas en su documentación (revisada el 7 de noviembre de 2026):

• una dirección raíz como https://example.com recibe /v1/chat/completions añadido;
• una dirección que termina en / recibe solo chat/completions añadido;
• una dirección que termina en # se usa exactamente como se escribió, sin añadir nada.

CheapTokens vive bajo /v1, así que https://api.cheaptokens.dev/v1/ es la forma que se convierte en https://api.cheaptokens.dev/v1/chat/completions — la ruta que espera la API. La vista previa bajo el campo debería mostrar exactamente eso. Si ves /v1/v1/ o ningún /v1, corrige el campo antes de continuar.

Clave, modelo y Model Check#

De vuelta en la página del proveedor hay cinco pequeños pasos. Hazlos en este orden:

Una nota sobre el paso 5. La página también tiene un botón Sync models que obtiene una lista de modelos del servicio. La ruta fiable es añadir el id tú mismo con +: escribe deepseek-ai/DeepSeek-V4-Flash-0731 exactamente, con la parte deepseek-ai/. Qué modelos puedes añadir:

Model Check es el botón junto al campo de la clave; según la documentación de Cherry Studio, comprueba que la clave es válida. Si da error, salta a la sección de errores de abajo: la causa suele ser uno de tres campos.

Envía el primer mensaje#

Abre un chat nuevo, elige el proveedor CheapTokens y el modelo que añadiste en el selector de modelos de la parte superior, y escribe algo breve, como 'Explica qué es un token en dos frases.' Una respuesta del modelo significa que toda la cadena funciona: clave, dirección, id del modelo.

¿Quieres ver una petición sin la app? Aquí tienes una llamada Chat Completions simple:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

La respuesta es JSON con el texto en choices[0].message.content y los recuentos de tokens en usage.

Qué modelo poner en un chat de escritorio#

Una ventana de chat es un trabajo distinto al de un bucle de agente: preguntas, lees, vuelves a preguntar. Entonces importan dos cosas: cuánto pueden medir las respuestas y cuánto cabe en una conversación.

• DeepSeek-V4-Flash — la opción por defecto para chat general y documentos largos: hasta 32.768 tokens de salida por respuesta, 380K de contexto, un precio a cualquier hora. En total, contando entrada y salida juntas, es más barato que OpenRouter.
• GLM-5.3-Flash — chat del día a día con la ventana más grande de los tres (390K), más barato que OpenRouter tanto en entrada como en salida.
• MiniMax-M2.7 — chat y tareas tipo agente con un contexto de 180K, más barato que OpenRouter en ambos lados.

Los tres están detrás de un mismo saldo, así que puedes añadir los tres ids al mismo proveedor y cambiar en el selector de modelos sin tocar la clave.

Cuánto cuesta una sesión de chat#

Aquí tienes una imagen aproximada. Supón que tienes una conversación de 20 mensajes. Cada mensaje reenvía el historial anterior, así que una petición promedia unos 6.000 tokens de entrada y 500 de salida (un motivo que se explica en por qué un chat largo cuesta más). Una petición en DeepSeek-V4-Flash cuesta $0.00014. Veinte de ellas están en la calculadora de abajo; mueve los controles para ajustarlos a tus propios chats.

La tabla de abajo ejecuta la misma sesión en todos los modelos, con una columna de OpenRouter para comparar:

Para ver los precios actuales por 1M de tokens, consulta precios de CheapTokens.

Si no funciona#

La mayoría de los problemas vienen de los mismos tres campos: clave, URL, id del modelo. Relaciona lo que ves con la causa:

Para un recorrido más largo por estos errores, consulta API 401 o 404: clave, base URL o id de modelo incorrectos. Y si prefieres un chat basado en navegador en lugar de una app de escritorio, Open WebUI funciona igual.

Fuentes: documentación de Cherry Studio, páginas de proveedor personalizado y ajustes de proveedor, revisadas el 7 de noviembre de 2026; el proyecto está en github.com/CherryHQ/cherry-studio.