HopBase DocsWorkBuddy
Use HopBase como proveedor de modelos compatible con OpenAI en WorkBuddy.
WorkBuddy puede llamar a un endpoint compatible con OpenAI como modelo subyacente, así que HopBase puede servir los modelos que hay detrás.
Genere la configuración en un paso (recomendado)
Pegue una clave de un grupo de chat. El generador la usa para llamar a GET /v1/models, muestra los modelos que WorkBuddy puede usar y arma un comando que escribe el archivo de configuración. Los ID de modelo deben coincidir exactamente, y leerlos con su clave evita errores de escritura.
El archivo de configuración es ~/.workbuddy/models.json, o %USERPROFILE%\.workbuddy\models.json en Windows. WorkBuddy lo recarga automáticamente, así que los modelos nuevos aparecen en el desplegable en cuanto se escribe.
El comando sustituye el archivo completo y antes guarda el anterior como models.json.bak-<fecha>. Si había añadido modelos a mano, copie esas entradas desde la copia de seguridad.
Rellene los ajustes a mano
| Ajuste | Valor |
|---|---|
| Protocolo / tipo de proveedor | OpenAI (Chat Completions) |
| Dirección de API / URL base | https://api.hop-base.com/v1 |
| Clave de API | Una clave de un grupo de modelos de chat |
| Modelo | El ID exacto que devuelve GET /v1/models para esa clave |
En la pantalla de ajustes basta con la URL base. Si edita models.json directamente, url necesita el endpoint completo:
https://api.hop-base.com/v1/chat/completionsVerificado en producción: WorkBuddy llega a POST /v1/chat/completions y hace streaming con normalidad.
Elija una clave con modelos de chat
Inicie sesión en la consola y use una clave cuyo grupo sirva modelos de chat con protocolo OpenAI: GPT / Codex, GLM, Kimi K3, DeepSeek, Qwen o Grok.
Lea el ID exacto del modelo
curl https://api.hop-base.com/v1/models \
-H "Authorization: Bearer sk-your-key"Copie un ID de la respuesta tal cual.
Rellene el proveedor
En los ajustes de proveedor de modelos de WorkBuddy, elija el tipo compatible con OpenAI e introduzca la URL base, la clave y el ID de modelo de los pasos anteriores.
Envíe un mensaje de prueba
Pida una respuesta de una sola palabra. Un viaje de ida y vuelta correcto confirma a la vez la clave, el grupo, el protocolo y el ID de modelo.
Errores frecuentes
| Error | Causa | Solución |
|---|---|---|
route_not_found | La clave es de un grupo de imagen o video, sin endpoint de chat | Use una clave de un grupo de chat |
404 model_not_found | El ID es un nombre corto, como glm | Use el ID completo, como glm-5.3 |
Grupos como Kling, Seedance, MiniMax y Wan / HappyHorse sirven endpoints multimedia basados en tareas, no chat/completions. Los ID de modelo llevan versión o fecha, así que cópielos siempre de GET /v1/models.
Modelos Claude
Claude usa el protocolo Anthropic, no Chat Completions, así que WorkBuddy no puede llamarlo. Apunte WorkBuddy a un grupo de chat que sirva modelos con protocolo OpenAI. Consulte Clientes de terceros para la tabla de protocolo por familia.
Prompts de sistema largos
WorkBuddy envía un contexto de instrucciones extenso, así que un solo turno puede llevar decenas de miles de tokens de entrada. Elija un modelo cuya ventana de contexto tenga espacio para ello, y tenga en cuenta que algunas familias cambian de nivel cuando la entrada supera cierto umbral; consulte la página de cada familia en Integración de modelos.
Próximos pasos
- Clientes de terceros: los mismos ajustes para Cherry Studio, NextChat y LobeChat
- Modelos disponibles: qué sirve cada grupo de plan
- Solución de problemas: busque un mensaje de error