Configuración de modelos de DeepSeek Harness

DeepSeek Harness puede usar la configuración oficial de DeepSeek, y también puede usar modelos de terceros.

Tipo de proveedor	Qué es	Requisitos de credenciales	Escenarios aplicables
DeepSeek	Endpoint oficial de DeepSeek	Clave API de DeepSeek (solo escritura)	Por defecto, el más rápido de comenzar
Proveedor de catálogo	Proveedores en el catálogo instalado, como Anthropic, OpenAI	Claves API de cada uno; los que usan autenticación nativa requieren sus propias credenciales	Integrar los principales fabricantes ya incluidos
Proveedor personalizado	Endpoints propios, como puertas de enlace de empresa o servidores propios	Provider ID, baseURL, protocolo, credenciales, modelo	Endpoints que no están en el catálogo

Abre http://127.0.0.1:3080/, toda la interfaz es la siguiente, podemos hacer clic primero en Configuración para configurar la API key:

Si aún no tienes una API, puedes ir ahttps://platform.deepseek.com/api_keysSolicitarla.

A continuación abre Configuración → Modelos, en la tarjeta de DeepSeek hay un campo de entrada de clave API, complétalo y guarda.

---

Añadir proveedor de catálogo

El proveedor de catálogo proporciona el endpoint, protocolo y lista de modelos desde el catálogo instalado de dsh.

Selecciona Añadir proveedor, elige un proveedor como Anthropic u OpenAI, ingresa su clave API y guarda.

El catálogo instalado trae automáticamente el endpoint, protocolo y lista de modelos, no necesitas completarlos manualmente.

Por ejemplo, configuramos el plan coding de Zhipu:

Una vez completada la configuración, podemos ver el modelo añadido en la lista de modelos del cuadro de diálogo:

Los proveedores que usan autenticación nativa requieren sus propias credenciales nativas; completar solo el campo de clave API no puede finalizar la configuración.

Proveedor	Credenciales nativas requeridas
Bedrock	Credenciales y región de AWS
Vertex	Proyecto ADC
Azure	api-version
Codex	OAuth

---

Añadir proveedor personalizado

Los endpoints que no existen en el catálogo, como puertas de enlace de empresa o servidores propios, se conectan con un proveedor personalizado.

Selecciona Añadir proveedor personalizado y completa los siguientes campos.

Campo	Descripción	¿Obligatorio?
Provider ID	Minúsculas, identificador permanente	Obligatorio
Nombre para mostrar	El nombre que se muestra en la interfaz	Opcional
URL base	El baseURL del endpoint	Obligatorio
Protocolo API	Como openai-completions	Obligatorio
Credenciales	Clave API o referencia a variable de entorno	Obligatorio
Modelo	Al menos un modelo	Obligatorio

El Provider ID es permanente, porque las solicitudes, las sesiones guardadas, los valores predeterminados de modelos y las referencias de credenciales lo utilizan.

Si necesitas renombrar un proveedor, añade un nuevo proveedor y elimina el antiguo.

El nombre para mostrar, la URL base, el protocolo, las credenciales y el modelo aún se pueden editar.

En el catálogo de modelos, selecciona Obtener modelos disponibles para consultar la URL base y las credenciales que muestra actualmente el formulario.

Seleccionar un candidato solo actualiza el borrador; el proveedor no se almacena hasta que se guarda.

El proveedor de catálogo utiliza el catálogo instalado y no realiza solicitudes de red.

---

Entrada de imágenes: declarar modalidad para modelos de visión

Los modelos ingresados manualmente se tratan como texto plano por defecto; para admitir imágenes, debe declararse explícitamente.

Debido a que no hay ningún paso que pueda preguntar al endpoint qué modalidades acepta, dsh adopta la estrategia de "declarar primero, usar después".

Adjuntar imágenes a este tipo de modelo se rechazará antes del envío, y se mencionará el modelo por su nombre.

Los modelos de visión bajo un proveedor personalizado necesitan añadir una línea; el formulario no tiene un campo correspondiente.

Por favor, añade input a ese modelo en $DSH_HOME/settings.yaml.

# 文件路径：$DSH_HOME/settings.yaml
# 顶层键 llm-pi-ai 是模型路由插件的 id，providers 下按提供方 id 组织
llm-pi-ai:
  providers:
    my-gateway:
      apiKeyEnv: GATEWAY_API_KEY          # 凭据引用：从 GATEWAY_API_KEY 环境变量读取
      api: openai-completions             # API 协议：OpenAI 兼容的补全协议
      baseURL: https://gateway.ejemplo.example/v1  # 你的网关端点
      models:
        - id: legacy-chat                 # 纯文本模型，不写 input 即按纯文本对待
        - id: vision-preview              # 视觉模型
          input: [text, image]            # 声明同时接受文本与图片

input acepta text e image, y solo afecta a ese modelo, por lo tanto una ruta puede atender a ambos tipos de modelos al mismo tiempo.

Omitirlo o escribirlo como una lista vacía son equivalentes.

En este caso se conservan las modalidades registradas por el catálogo instalado para ese modelo; los modelos no descritos en el catálogo recurren al defaultInput de esa ruta.

Si todos los modelos que ingresaste manualmente aceptan imágenes, puedes establecer un valor de respaldo una vez en la ruta.

# 文件路径：$DSH_HOME/settings.yaml
# defaultInput 是回退值而不是覆盖值，默认为 [text]
llm-pi-ai:
  providers:
    vision-gateway:
      apiKeyEnv: GATEWAY_API_KEY
      api: openai-completions
      baseURL: https://vision.ejemplo.example/v1
      defaultInput: [text, image]         # 对本路由下目录未描述的模型生效
      models:
        - id: first-model
        - id: second-model

Para restringir las modalidades de un modelo en el proveedor de catálogo, escríbelo en modelOverrides, usando el id del modelo como clave.

# 文件路径：$DSH_HOME/settings.yaml
# 目录提供方没有可填写的 models 列表，覆盖走 modelOverrides
llm-pi-ai:
  providers:
    anthropic:
      modelOverrides:
        claude-sonnet-4-5:
          input: [text]                   # 把该模型的图片能力去掉

input y defaultInput son afirmaciones sobre tu endpoint, no comprobaciones del mismo.

Los modelos que declaran una capacidad de imagen que el endpoint no proporciona no se bloquearán aquí; en su lugar, el proveedor rechazará la solicitud.

---

Tabla de solución de problemas

Cuando ocurre un error en la configuración del modelo, dsh muestra un mensaje de error claro; consulta la siguiente tabla para solucionarlo.

Error	Significado	Solución
MISSING_CREDENTIAL	Falta la clave del proveedor	Almacena la clave del proveedor en la página de modelos, o proporciona la variable de entorno referenciada
UNKNOWN_MODEL	El modelo solicitado no está configurado	Selecciona un modelo configurado, o añade el modelo faltante al proveedor personalizado
Obtener modelos disponibles devuelve 401	La clave no es válida, o el endpoint no admite el descubrimiento de modelos	Verifica la clave; el descubrimiento de modelos llama a GET /models compatible con OpenAI; para servicios que no proporcionan ese endpoint, ingresa los modelos manualmente
La imagen se rechaza antes del envío	El modelo no declara la modalidad de imagen	Añade input: [text, image] al modelo del proveedor personalizado; la propia ruta de DeepSeek es de texto plano y no se puede cambiar mediante configuración
El proveedor rechazó la solicitud con imagen	El modelo declaró una capacidad de imagen que el endpoint en realidad no proporciona	Elimina image de la lista que le otorga la capacidad de imagen, e inicia una nueva sesión

Otras extensiones