Añade todos los modelos del catálogo a Chatbox con un solo proveedor personalizado.
Updated 2026-07-29
Chatbox incluye un flujo de Add Custom Provider para cualquier endpoint compatible con OpenAI: elige el modo OpenAI API Compatible, define el API Host como https://api.apisrouter.com/v1, pega una clave, y los ids de Claude, GPT, Gemini y DeepSeek conviven en el selector de modelos en escritorio, móvil y web.
Respuesta rápida: un diálogo en la configuración de Model Provider.
Abre Settings en Chatbox y cambia a la pestaña Model Provider. Haz clic en Add y luego en Add Custom Provider. Rellena el diálogo con cinco valores: un Name (APIsRouter), API Mode definido como OpenAI API Compatible, tu clave en API Key, https://api.apisrouter.com/v1 en API Host, y deja API Path en el valor por defecto /chat/completions que Chatbox rellena para un host que termina en /v1. Después añade modelos. El botón Fetch obtiene la lista de modelos del endpoint a través de /v1/models para que puedas activar ids del catálogo directamente, y New te permite escribir un id a mano si prefieres un selector corto y curado. Haz clic en Check junto al campo de clave y Chatbox ejecuta una petición en vivo; una confirmación en verde significa que el proveedor está conectado. Validamos este flujo exacto contra la app web actual de Chatbox, y el mismo diálogo se incluye en las versiones de escritorio y móvil.
Cómo habla Chatbox con un proveedor personalizado.
Chatbox (chatboxai en GitHub, unas 41K estrellas) es uno de los clientes de chat con IA más instalados: apps nativas para Windows, macOS y Linux, versiones móviles para iOS y Android, y una versión de navegador en web.chatboxai.app. Viene con entradas propias para los grandes proveedores, cada una pidiendo su propia clave, y el diálogo de proveedor personalizado es la vía documentada para todo lo demás. Un proveedor personalizado en modo OpenAI API Compatible es una descripción sencilla de un endpoint: host, ruta, clave y una lista de ids de modelo. Cada turno de conversación se convierte en una petición estándar de chat completions contra ese host, con el id de modelo del selector viajando como una cadena de texto. A Chatbox no le importa qué proveedor entrenó el modelo detrás de un id, y eso es precisamente lo que hace útil un gateway multi-proveedor aquí: una sola entrada de proveedor pone claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash y deepseek-v4-flash en el mismo selector, facturados a través de la misma clave. La diferencia práctica frente a apilar cuatro proveedores propios no es solo tener menos claves. La configuración de Chatbox se sincroniza por dispositivo, así que cada cuenta de proveedor que añades es otra clave que pegar en tu teléfono, tu portátil y la app web. Un solo proveedor personalizado es un solo pegado por dispositivo, y cambiar una conversación de Claude a DeepSeek es un cambio de selector, no un cambio de proveedor.
Configuración completa: todos los campos del diálogo.
Name es solo una etiqueta; APIsRouter mantiene el selector legible. API Mode debe ser OpenAI API Compatible, que le indica a Chatbox que hable chat completions estándar; el otro modo en el desplegable es para endpoints nativos de Gemini y no es lo que quiere un gateway. API Host y API Path se combinan para formar la URL de la petición, y este par es donde suelen fallar las configuraciones. Con el host definido como https://api.apisrouter.com/v1, la ruta es /chat/completions, y Chatbox rellena exactamente eso cuando reconoce un host con /v1. La documentación de Chatbox también describe la convención de host sin /v1, donde el host omite /v1 y la ruta por defecto es /v1/chat/completions; ambas formas componen la misma URL, así que elige una forma y deja el otro campo en su valor por defecto. Lo que rompe las cosas es mezclarlas: un host con /v1 junto a una ruta /v1/chat/completions, que produce una URL /v1/v1 duplicada que da 404. Las etiquetas de los campos y el comportamiento de autocompletado cambian un poco entre versiones de Chatbox, así que confía en la URL compuesta antes que en la memoria. Para los modelos, Fetch es la vía de bajo esfuerzo: Chatbox lista todo lo que sirve el endpoint y tú activas lo que quieres. New es la vía curada: escribe ids a mano y el selector se mantiene corto. Cada fila de modelo tiene interruptores de capacidad (visión, uso de herramientas); déjalos apagados a menos que sepas que el modelo soporta esa capacidad, ya que un modelo sin configurar se trata como texto plano, y ese es el comportamiento seguro por defecto. Termina con Check, luego inicia una conversación y elige un modelo bajo el nombre de tu nuevo proveedor.
Name: APIsRouter
API Mode: OpenAI API Compatible
API Key: sk-YOUR-APISROUTER-KEY
API Host: https://api.apisrouter.com/v1
API Path: /chat/completions (autofilled)
Models: Fetch (pull the catalog) or New (type ids)
Then: Check → green confirmationElegir modelos para un cliente de chat de uso diario.
Como cada modelo habilitado factura a través de una sola clave, comparar dos ids es un cambio de selector y no una decisión de cuenta. Ejecuta el mismo tipo de conversaciones en ambos durante unos días, luego revisa el gasto por modelo en la consola de APIsRouter y quédate con el que se ganó su lugar.
- Las preguntas del día a día y las reescrituras rápidas son trabajo en ráfagas. claude-haiku-4-5-20251001 y gemini-3.5-flash responden lo bastante rápido como para que la app se sienta instantánea, y llevan bien la mayor parte del tráfico cotidiano.
- La redacción larga, el razonamiento cuidadoso y las discusiones de código se ganan claude-sonnet-4-6 o gpt-5.5. Mantén uno de cada nivel habilitado y cambia por conversación en lugar de por proveedor.
- deepseek-v4-flash es la elección de volumen si Chatbox es tu barra lateral siempre abierta; las conversaciones pequeñas y constantes se acumulan, y el nivel rápido hace que el saldo baje despacio.
- Las conversaciones con entrada de imagen necesitan un id con capacidad de visión y el interruptor de visión activado en esa fila de modelo; confirma la capacidad en la documentación del modelo antes de activar el interruptor.
- Habilita pocos modelos con intención en lugar de traerlos todos con Fetch: cada interruptor es una fila del selector, y añadir otro id más adelante es una edición de diez segundos.
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.
| Modelo | Precio oficial | Nuestro precio |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| Gemini 3.5 Flash | $1.50 / $9.00 per M | $1.20 / $7.20 per M |
| DeepSeek V4 Flash | $0.14 / $0.28 per M | $0.10 / $0.30 per M |
Modos de fallo específicos de Chatbox.
La ruta duplicada es el clásico. Un 404 en cada mensaje significa que API Host y API Path llevan ambos un /v1, o que la ruta repite lo que el host ya termina; abre la entrada del proveedor y lee los dos campos como una sola URL. Un resultado vacío de Fetch normalmente significa que la clave es incorrecta o falta, ya que el listado de modelos es en sí mismo una petición autenticada. Revisa el campo API Key y usa el botón Check, que muestra los errores de autenticación directamente. Un modelo que da error solo en algunas conversaciones suele ser un interruptor de capacidad: visión activada en un modelo que no acepta entrada de imagen, o un flujo dependiente de herramientas que llega a un modelo con las herramientas desactivadas. Restablece la fila del modelo a sus valores por defecto y reactiva las capacidades de una en una. Y recuerda que la entrada de proveedor vive por instalación. Añadir APIsRouter en tu escritorio no configura tu teléfono; repite el diálogo allí, o usa la función propia de Chatbox para compartir configuración si tu versión la ofrece. Lo único que nunca hay que repetir son los registros con cada proveedor, ya que una sola clave cubre todos los modelos en todos los dispositivos.
Quién enruta Chatbox a través de un gateway.
- Personas que quieren Claude, GPT, Gemini y DeepSeek en un solo selector sin mantener cuatro cuentas de proveedor y cuatro claves en tres dispositivos.
- Usuarios en regiones donde registrarse con algunos proveedores es complicado; el acceso basado en recarga sin necesidad de tarjeta elimina la dependencia de cada proveedor.
- Desarrolladores que ya enrutan sus herramientas de editor y terminal a través de un gateway y quieren que su cliente de chat use la misma clave y el mismo registro de uso.
- Quienes comparan modelos en conversaciones reales antes de comprometer un proyecto con uno; cada candidato es una fila del selector, no una cuenta.
- Hogares y equipos pequeños que se estandarizan en un solo endpoint, un solo saldo y visibilidad de uso por clave en lugar de suscripciones dispersas.
Verifica el endpoint y depura el primer mensaje.
Primero comprueba la mitad del gateway fuera de Chatbox: lista los modelos con tu clave, luego ejecuta una chat completion contra un id que planeas habilitar. Si ambas pasan, todo lo que queda está en el diálogo del proveedor. Dentro de Chatbox, el botón Check es la señal más rápida. Los errores de autenticación son el campo de clave. Los errores de «no encontrado» al enviar son un desajuste de id, que ocurre sobre todo con entradas New escritas a mano; copia los ids de la salida de /v1/models en lugar de confiar en la memoria. Los 404 en cada petición son la composición de host/ruta descrita arriba. Una vez que los mensajes fluyen, la consola de APIsRouter muestra el modelo, el recuento de tokens y el gasto por petición. Un cliente de chat genera muchas peticiones pequeñas a lo largo del día, y el registro de uso es donde ese hábito se convierte en una cifra por modelo y por día que realmente puedes leer.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-haiku-4-5-20251001",
"messages":[{"role":"user","content":"ping"}]}'Preguntas frecuentes
¿Cómo añado un API Host personalizado a Chatbox?
Settings, pestaña Model Provider, Add, y luego Add Custom Provider. Define API Mode como OpenAI API Compatible, API Host como https://api.apisrouter.com/v1, pega tu clave y deja API Path en su valor por defecto /chat/completions. Añade modelos con Fetch o New, y luego pulsa Check.
¿Debe el API Host incluir /v1?
Cualquiera de las dos formas funciona siempre que el host y la ruta compongan /v1/chat/completions exactamente una vez. Con el host https://api.apisrouter.com/v1 la ruta es /chat/completions; con un host sin /v1 la ruta por defecto es /v1/chat/completions. Mezclar ambas duplica el /v1 y da 404.
¿Puede Chatbox ejecutar Claude, Gemini y DeepSeek a través de una sola entrada de proveedor?
Sí. En modo OpenAI API Compatible, el id de modelo viaja hacia el API Host como una simple cadena de texto, así que una sola entrada puede habilitar claude-sonnet-4-6, gemini-3.5-flash y deepseek-v4-flash juntos, todos facturados a través de la misma clave e intercambiables en el selector.
¿Por qué Fetch no devuelve ningún modelo?
Fetch llama al listado /v1/models del endpoint con tu clave, así que un resultado vacío casi siempre es un problema de autenticación. Revisa de nuevo el campo API Key y ejecuta el botón Check; una vez que la clave pasa, Fetch lista todos los ids que sirve el gateway.
¿El proveedor personalizado también funciona en Chatbox móvil y web?
Sí, el diálogo Add Custom Provider está disponible en las versiones de escritorio, móvil y web. Las entradas de proveedor se configuran por instalación, así que repite esta configuración de un solo diálogo en cada dispositivo con la misma clave.
¿Necesito interruptores de capacidad en todos los modelos?
No. Un modelo sin configurar funciona como chat de texto plano, que es el comportamiento seguro por defecto. Activa los interruptores de visión o herramientas solo en modelos que realmente soporten esa capacidad, ya que un interruptor activado por error produce errores confusos justo en las conversaciones que lo usan.