Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

DEEPSEEK HARNESS + RUNAPI

Usa RunAPI en DeepSeek Harness.

Añade RunAPI como Custom model API en dsh, apunta a https://runapi.ai/v1 mediante OpenAI Chat Completions y conversa con gpt-5.4-nano desde la interfaz web o en modo sin interfaz.

Comprobado con dsh 0.2.1-rc.2 contra un stub local · sin llamadas de pago al proveedor
- id: llm-pi-ai
  config:
    providers:
      runapi:
        apiKeyEnv: RUNAPI_API_KEY
        api: openai-completions
        baseURL: https://runapi.ai/v1
        models:
          - id: gpt-5.4-nano
- id: agent-default-model
  config:
    provider: runapi
    model: gpt-5.4-nano
export RUNAPI_API_KEY="runapi_xxx"
npx @deepseek-ai/[email protected] --version
npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
npx @deepseek-ai/[email protected] web --patch runapi.patch.yml
Comprobado con dsh 0.2.1-rc.2/v1
ALCANCE

Un modelo, un chat de texto

Objetivo

Permitir que los usuarios de DeepSeek Harness envíen solicitudes de chat a través de RunAPI con su propia URL base y clave de API, sin un complemento nativo del proveedor.

Configuración mínima funcional

Un proveedor Custom model API llamado runapi, un modelo, gpt-5.4-nano, y un mensaje de texto que reciba una respuesta.

Versión fijada

La configuración y los comandos se comprobaron con @deepseek-ai/dsh 0.2.1-rc.2. Fija esa versión con npx hasta que hayas comprobado una versión más reciente por tu cuenta.

Alcance sin llamadas de pago

La carga de dsh, el formato de las solicitudes, las respuestas y los mensajes de error se comprobaron contra un stub local del endpoint de RunAPI. No se realizó ninguna solicitud de pago a un proveedor para esta página.

CONFIGURACIÓN

Conecta dsh a RunAPI en tres pasos

1

Exporta la clave de RunAPI

Define RUNAPI_API_KEY en la terminal desde la que inicias dsh. El parche lee la clave del entorno, por lo que nunca se guarda en un archivo.

export RUNAPI_API_KEY="runapi_xxx"
2

Añade Custom model API

Guarda runapi.patch.yml para --patch o añade los valores en Settings → Models → Add model provider → Custom model API. La interfaz guarda su propio perfil y la clave en el almacén de credenciales; --patch deja estos campos de Settings en modo de solo lectura.

api: openai-completions
3

Envía un mensaje de texto

Ejecuta una tarea sin interfaz o abre la interfaz web con el parche. En la interfaz, selecciona runapi/gpt-5.4-nano en el selector de modelos antes de chatear. Una respuesta en la terminal o en el chat indica que dsh ha llegado a RunAPI.

npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
REFERENCIA

Campos de Custom model API

Campo Valor Finalidad
ID del proveedor runapi ID permanente que utilizan las sesiones, los valores predeterminados y la referencia a las credenciales.
URL base https://runapi.ai/v1 Envía las solicitudes al endpoint de RunAPI compatible con OpenAI.
Protocolo de API openai-completions OpenAI Chat Completions, que RunAPI ofrece en /v1/chat/completions.
Credencial RUNAPI_API_KEY Se lee del entorno mediante apiKeyEnv o se guarda desde la página Models.
Modelo gpt-5.4-nano Modelo de texto síncrono de bajo coste del catálogo de RunAPI.
COMPROBACIÓN DEL CHAT

Comprueba la clave y el modelo antes de usar dsh

Esta solicitud síncrona usa la misma URL base, clave y modelo que el parche y limita la respuesta a 64 tokens. Si devuelve un mensaje, cualquier fallo de dsh está en su configuración y no en la cuenta de RunAPI.

curl https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.4-nano", "max_tokens": 64, "messages": [{"role": "user", "content": "Reply with one short sentence."}]}'
SOLUCIÓN DE PROBLEMAS

Errores de DeepSeek Harness

dsh se detiene con MISSING_CREDENTIAL. ¿Qué falta?

RUNAPI_API_KEY no está definida en la terminal desde la que se inició dsh. Expórtala o guarda la clave en la página Models y vuelve a ejecutar el mismo comando.

dsh muestra un 404 o un error de conexión. ¿Es incorrecta la URL base?

Normalmente sí. La URL base debe ser exactamente https://runapi.ai/v1; dsh añade /chat/completions por su cuenta. Un error de conexión significa que no se pudo contactar con el servidor.

dsh muestra 404 Resource not found con la URL correcta. ¿Qué debo comprobar?

Verifica el ID del modelo en el catálogo de modelos de RunAPI, por ejemplo gpt-5.4-nano, y comprueba que agent-default-model use el proveedor runapi y el ID del modelo correspondientes.

¿Necesito un complemento nativo de proveedor para RunAPI?

No. dsh incluye compatibilidad con Custom model API para OpenAI Chat Completions y RunAPI ofrece ese protocolo, así que el parche basta para el chat de texto.

Obtén una clave de RunAPI para dsh.

Crea una cuenta de RunAPI o inicia sesión, crea una clave de API y expórtala como RUNAPI_API_KEY antes de iniciar dsh.