It looks like you may prefer a different language. Switch anytime.

DEEPSEEK HARNESS + RUNAPI

Use o RunAPI no DeepSeek Harness.

Adicione o RunAPI como Custom model API no dsh, aponte para https://runapi.ai/v1 via OpenAI Chat Completions e converse com gpt-5.4-nano pela interface web ou em uma execução sem interface.

Verificado com dsh 0.2.1-rc.2 usando um stub local · sem chamadas pagas ao provedor upstream
- 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
Verificado com dsh 0.2.1-rc.2/v1
ESCOPO

Um modelo, uma conversa por texto

Objetivo

Permitir que usuários do DeepSeek Harness encaminhem solicitações de chat pelo RunAPI com sua própria URL base e chave de API, sem um plugin nativo do provedor.

Configuração mínima funcional

Um provedor Custom model API chamado runapi, um modelo, gpt-5.4-nano, e uma mensagem de texto que receba uma resposta.

Versão fixada

A configuração e os comandos foram verificados com @deepseek-ai/dsh 0.2.1-rc.2. Fixe essa versão com npx até verificar uma versão mais recente por conta própria.

Verificação sem chamadas pagas

O carregamento do dsh, o formato das solicitações, as respostas e as mensagens de erro foram verificados usando um stub local do endpoint do RunAPI. Nenhuma solicitação paga ao provedor upstream foi feita para esta página.

CONFIGURAÇÃO

Conecte o dsh ao RunAPI em três etapas

1

Exporte a chave do RunAPI

Defina RUNAPI_API_KEY no shell que inicia o dsh. O patch lê a chave do ambiente, então ela nunca é gravada em um arquivo.

export RUNAPI_API_KEY="runapi_xxx"
2

Adicione Custom model API

Salve runapi.patch.yml para --patch ou adicione os valores em Settings → Models → Add model provider → Custom model API. A interface salva seu próprio perfil e a chave no armazenamento de credenciais; --patch torna esses campos de Settings somente leitura.

api: openai-completions
3

Envie uma mensagem de texto

Execute uma tarefa sem interface ou abra a interface web com o patch. Na interface, selecione runapi/gpt-5.4-nano no seletor de modelos antes de conversar. Uma resposta no terminal ou no chat significa que o dsh alcançou o RunAPI.

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

Campos de Custom model API

Campo Valor Finalidade
ID do provedor runapi ID permanente usado pelas sessões, pelos padrões e pela referência à credencial.
URL base https://runapi.ai/v1 Envia solicitações ao endpoint do RunAPI compatível com OpenAI.
Protocolo da API openai-completions OpenAI Chat Completions, que o RunAPI oferece em /v1/chat/completions.
Credencial RUNAPI_API_KEY Lida do ambiente com apiKeyEnv ou salva pela página Models.
Modelo gpt-5.4-nano Modelo de texto síncrono de baixo custo no catálogo do RunAPI.
TESTE DO CHAT

Verifique a chave e o modelo antes de usar o dsh

Esta solicitação síncrona usa a mesma URL base, chave e modelo do patch e limita a resposta a 64 tokens. Se retornar uma mensagem, uma falha no dsh está na configuração do dsh, e não na conta do 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."}]}'
SOLUÇÃO DE PROBLEMAS

Erros do DeepSeek Harness

O dsh para com MISSING_CREDENTIAL. O que está faltando?

RUNAPI_API_KEY não está definida no shell que iniciou o dsh. Exporte a variável ou salve a chave na página Models e execute o mesmo comando novamente.

O dsh informa um erro 404 ou de conexão. A URL base está errada?

Geralmente, sim. A URL base deve ser exatamente https://runapi.ai/v1; o dsh acrescenta /chat/completions por conta própria. Um erro de conexão significa que não foi possível alcançar o host.

O dsh informa 404 Resource not found com a URL correta. O que devo verificar?

Verifique o ID do modelo no catálogo de modelos do RunAPI, como gpt-5.4-nano, e confira se agent-default-model usa o provedor runapi e o ID do modelo correspondentes.

Preciso de um plugin nativo de provedor do RunAPI?

Não. O dsh inclui suporte a Custom model API para OpenAI Chat Completions, e o RunAPI oferece esse protocolo, então o patch basta para conversas por texto.

Obtenha uma chave do RunAPI para o dsh.

Crie uma conta no RunAPI ou entre na sua conta, crie uma chave de API e exporte-a como RUNAPI_API_KEY antes de iniciar o dsh.