HopBase DocsDeepSeek Harness (dsh)
Conecte DeepSeek Harness a HopBase con un proveedor personalizado.
DeepSeek Harness (dsh) es el runtime de agentes de código abierto de DeepSeek. Llega a cualquier pasarela mediante un proveedor personalizado: URL base, protocolo e ID de modelo, sin nada codificado.
Elija el protocolo según la familia de modelos
dsh necesita saber qué protocolo hablar. Eso depende de la familia de modelos, no de dsh.
| Familia de modelos | api | baseURL |
|---|---|---|
| DeepSeek, GPT / Codex, GLM, Kimi, Grok, Qwen | openai-completions | https://api.hop-base.com/v1 |
| Claude | anthropic-messages | https://api.hop-base.com (sin /v1) |
Una clave de HopBase llega a las familias de modelos de los grupos de plan que incluye. Si quiere DeepSeek y Claude en la misma instalación de dsh, añada dos proveedores, uno por protocolo; ambos pueden usar la misma clave si incluye los dos grupos. Una clave sin el grupo del modelo devuelve 404 model_not_found.
Configuración con el archivo de ajustes
Las llamadas a funciones y el consumo en streaming se han verificado de extremo a extremo contra HopBase.
Añada un proveedor
Abra $DSH_HOME/settings.yaml y añada una entrada bajo providers:
providers:
hopbase:
api: openai-completions
baseURL: https://api.hop-base.com/v1
apiKeyEnv: HOPBASE_API_KEY
models:
- id: deepseek-v4-pro-202606
- id: deepseek-v4-flash-202605
- id: glm-5.3Liste solo los modelos que su clave puede alcanzar realmente. Lea los ID exactos con GET /v1/models usando esa clave en lugar de copiar este ejemplo.
Exporte la clave
export HOPBASE_API_KEY=sk-your-keyapiKeyEnv indica el nombre de la variable de entorno; dsh lee la clave de ahí al arrancar. Nunca escriba la clave dentro de settings.yaml.
Compruebe la lista de modelos
curl https://api.hop-base.com/v1/models \
-H "Authorization: Bearer sk-your-key"Cada ID que haya listado en models debe aparecer en esta respuesta. Si falta alguno, ninguno de los grupos de esa clave lo sirve.
Envíe una primera solicitud
Arranque dsh, seleccione el proveedor y pida una respuesta de una sola palabra. Un viaje de ida y vuelta correcto confirma a la vez la URL base, la clave, el protocolo y el ID de modelo.
Configuración desde la interfaz web
Settings → Models → Add a custom provider, y rellene los mismos cuatro valores: protocolo, URL base, variable de la clave e ID de modelo. La tabla de protocolos de arriba también se aplica aquí.
Añadir una segunda familia
Para usar Claude junto a DeepSeek, añada un segundo proveedor en lugar de editar el primero: el protocolo y la URL base son distintos.
providers:
hopbase:
api: openai-completions
baseURL: https://api.hop-base.com/v1
apiKeyEnv: HOPBASE_API_KEY
models:
- id: deepseek-v4-pro-202606
hopbase-claude:
api: anthropic-messages
baseURL: https://api.hop-base.com
apiKeyEnv: HOPBASE_CLAUDE_API_KEY
models:
- id: claude-sonnet-5Resolución de problemas
| Síntoma | Causa |
|---|---|
401 en todas las solicitudes | La variable de entorno indicada en apiKeyEnv no está definida en el shell que lanzó dsh |
404 model_not_found | El modelo no lo sirve ninguno de los grupos de esa clave, o el ID se abrevió. Vuelva a leer GET /v1/models |
404 solo en Claude | La baseURL lleva el sufijo /v1. El protocolo Anthropic usa el host sin ruta |
| Las solicitudes llegan al modelo equivocado | Dos proveedores comparten el mismo apiKeyEnv. Dé a cada familia su propia variable |
Próximos pasos
- DeepSeek V4 es el contrato de modelo detrás de esta página: endpoints, salida de razonamiento, caché y las reescrituras de solicitud que debe esperar
- Modelos disponibles: consulte los ID de modelo disponibles para una clave
- Solución de problemas: busque un mensaje de error