Chatbox es un cliente de IA multiplataforma que funciona tanto en computadora de escritorio como en celular. Puede usar directamente el servicio integrado Chatbox AI o aportar tu propia clave API para conectarte a tu proveedor de modelos. Este artículo trata solo el segundo caso: desde la instalación hasta la conexión de un proveedor compatible con OpenAI, con verificación, sincronización y configuración para equipos.

Nota: Chatbox es una marca de su titular; este artículo solo ofrece una explicación técnica de integración y no implica relación con el equipo de Chatbox. Los nombres de la interfaz y la ubicación de las opciones dependen de la versión actual; los modelos y precios se consultan en la página de precios de modelos del sitio.

1. Instalación: confirma primero la plataforma y la versión

La versión de escritorio conviene para conversaciones largas, documentos extensos y capturas de pantalla; la versión móvil, para consultas rápidas en ratos libres. Ambas pueden usarse de forma complementaria, pero los accesos de configuración no son idénticos.

Al instalar, ten en cuenta tres puntos:

  1. Descarga desde canales confiables y verifica el nombre de la aplicación y los datos del desarrollador antes de instalar.
  2. En computadoras de empresa, confirma primero la lista blanca de software para evitar que el equipo quede sin conexión.
  3. Después de instalar, actualiza a la versión estable actual antes de configurar.

Las versiones antiguas pueden no incluir el «proveedor de modelos personalizado» o usar nombres de campo distintos a los de este tutorial. Si fuerzas los valores de una guía vieja, lo más habitual es pegar la clave en la casilla equivocada. Primero actualiza; después compara con la interfaz real.

2. Tres parámetros que debes preparar

Sea cual sea el gateway que uses, un proveedor personalizado solo necesita tres cosas:

Parámetro Ejemplo Error habitual
Clave API sk-... Copiarla con espacios o saltos de línea
Base URL https://ai.zhongshangqihang.com/v1 Escribir la dirección completa del endpoint
ID del modelo Según la página de precios Usar el nombre visible en lugar del identificador API

La clave se crea tras registrarte en ZSQH AI Gateway; se recomienda nombrarla por dispositivo y uso, por ejemplo chatbox-mac-work. La Base URL es la dirección compatible con OpenAI del gateway. El ID del modelo se copia de la página de precios de modelos y debes respetar mayúsculas, sufijo de versión y guiones.

Anota los tres parámetros en un lugar temporal y decide si guardarlos cuando termine la configuración. No escribas la clave en documentos públicos ni en historiales de chat.

3. Agregar un proveedor compatible con OpenAI

El texto de los botones cambia entre versiones, pero el orden de los pasos es similar:

  1. Abre Chatbox y entra en «Ajustes».
  2. Busca «Proveedores de modelos» o «Servicios de modelos».
  3. Pulsa «Agregar» o «+» para crear un proveedor.
  4. Ponle un nombre fácil de reconocer, como «ZSQH».
  5. Elige el modo de API compatible con OpenAI; no selecciones el modo Anthropic ni Gemini.
  6. Introduce la clave API y la Base URL.
  7. Pulsa «Obtener» para cargar la lista de modelos; si falla, agrega el ID manualmente.
  8. Pulsa «Comprobar» para probar la conexión y selecciona el modelo recién agregado.

Un proveedor puede contener varios modelos. Conviene reunir los modelos de chat, visión y razonamiento en el mismo proveedor para no equivocarte al cambiar. Si tienes un entorno de prueba y otro de producción, crea dos proveedores y distínguelos con un prefijo.

4. Cómo completar la Base URL y el ID del modelo

La Base URL es el campo que más errores genera. Debe terminar en /v1, porque el cliente concatena después la ruta del endpoint. Si también escribes /chat/completions, el cliente puede agregarlo otra vez y el resultado será un 404.

El orden de diagnóstico cabe en dos frases:

  • Ante 401, revisa primero la clave: si caducó, si fue eliminada o si tiene espacios delante o detrás.
  • Ante 404, revisa primero la ruta: prueba a agregar o quitar /v1 al final, cambiando solo una variable cada vez.

El ID del modelo debe coincidir con el identificador API de la página de precios. El nombre visible suele ser más claro, pero no sirve para las solicitudes. En modelos con fecha, número de versión o sufijos como -mini, revisa carácter por carácter.

5. Verificación: primero curl y después el cliente

Antes de tocar el cliente, comprueba en la terminal que el gateway responde. Así descartas la mitad de los problemas posibles:

export ZSQH_API_KEY="sk-tu-clave"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tu-modelo-id",
    "messages": [{"role": "user", "content": "Responde solo OK"}]
  }'

Si el JSON devuelto contiene choices, la clave, la dirección y el modelo son válidos. Después vuelve al cliente y haz tres comprobaciones:

  1. Envía una pregunta corta y confirma que el primer token llega con normalidad.
  2. Encadena dos preguntas más y confirma que no se pierde el contexto.
  3. Pide una respuesta larga y confirma que no se corta a mitad.

Si solo se cortan las respuestas largas, revisa primero la red y la salida en streaming; si fallan todas las solicitudes, vuelve a la clave y a la Base URL. Que la opción «Comprobar» del cliente pase solo indica conectividad básica, no que todas las capacidades estén disponibles.

6. Ajustes y sincronización: escritorio y celular

Los ajustes de Chatbox suelen incluir modelo predeterminado, temperatura, longitud de contexto, proxy y directorio de datos. Conviene cambiar primero tres: modelo predeterminado, salida en streaming y ubicación de los datos. Deja el resto con los valores predeterminados hasta que todo funcione.

Escenario Práctica recomendada Atención
Uso diario en escritorio Guardar la configuración del proveedor y fijar el modelo predeterminado Exportar copias de las conversaciones con regularidad
Consultas puntuales en celular Configurar un proveedor aparte y cargar pocos modelos En un teléfono compartido, no guardar la clave a largo plazo
Cambio de computadora Volver a introducir la clave y el ID del modelo No copiar el directorio de configuración completo
Varias personas en un equipo Usar cuentas independientes del sistema Evitar que conversaciones y claves queden visibles entre sí

Que exista sincronización en la nube y qué incluye depende de la versión actual y de la forma de inicio de sesión; consulta la página de datos dentro de la aplicación. No des por hecho que «el historial se sincroniza y la clave también». En la mayoría de los casos, la clave es una configuración local y hay que volver a escribirla al cambiar de dispositivo. Los archivos de respaldo exportados también pueden contener información sensible y deben tratarse como un archivo de credenciales.

7. Uso en equipo: tratar la configuración como infraestructura

Lo que más se descuida en equipos pequeños no es la conexión, sino el traspaso. Como mínimo:

  • Emitir una clave por persona, sin compartir una sola clave entre todos.
  • Unificar los nombres de proveedor, por ejemplo con el prefijo ZSQH-.
  • Configurar presupuestos o alertas de uso en el gateway para evitar consumo por sesiones olvidadas.
  • Cuando alguien deja el equipo o se pierde un dispositivo, revocar primero la clave y después ocuparse de las demás cuentas.
  • Documentar internamente la Base URL, los ID de modelo y la versión del cliente.

El valor de esto no es «gestionar de forma más ordenada», sino localizar rápido el origen de un fallo: si dejó de funcionar la clave de una persona, si retiraron un modelo o si las versiones del cliente no coinciden.

8. Preguntas frecuentes

¿Chatbox funciona sin clave API?

Puedes usar el servicio integrado Chatbox AI; la cuota y la forma de cobro dependen de la versión actual. El modo de clave propia utiliza el proveedor de API que configures, y el proveedor cobra según el consumo. No conviene mezclar ambos modelos de coste.

¿La Base URL debe incluir /v1?

La mayoría de las configuraciones compatibles con OpenAI necesitan /v1. Si falla tanto con como sin él, usa primero curl para encontrar la dirección completa que sí devuelve resultados y cópiala en el cliente; no lo hagas por prueba y error.

Si falla «Obtener modelos», ¿la clave está mal?

No necesariamente. Puede que el gateway no exponga la interfaz de lista de modelos o que la ruta no sea correcta. Agrega manualmente un ID de modelo y valida con «Comprobar» o con una conversación real. Si la carga manual funciona, el problema es solo la interfaz de lista.

¿Funciona en escritorio pero no en celular?

Confirma primero que ambos lados usan la misma Base URL y el mismo ID de modelo, y revisa después si la red del celular bloquea las solicitudes. La entrada móvil y las capacidades disponibles pueden diferir de las de escritorio; guíate por la versión actual. No guardes a largo plazo una clave de permisos amplios en el teléfono.

¿La configuración se conserva al cambiar de computadora?

Que se conserven el historial y la configuración depende de si inicias sesión con una cuenta, de si usas sincronización y de si exportaste una copia de seguridad. Se recomienda volver a escribir la clave y revocar la del dispositivo antiguo cuando confirmes que ya no lo usarás.

Próximos pasos

Conectar Chatbox a una API personalizada se reduce a tres pasos: instalar la versión correcta, completar bien la Base URL y elegir bien el ID del modelo. Verifica primero con curl y después pasa al cliente; ante un error, revisa la clave si ves 401, la ruta si ves 404 y el ID si el modelo no existe. Si necesitas un punto de acceso unificado y gestión de uso, puedes registrarte en ZSQH AI Gateway; los modelos y precios se consultan en la página de precios de modelos.

Lecturas relacionadas: