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.
Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.
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.
- 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
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.
Um provedor Custom model API chamado runapi, um modelo, gpt-5.4-nano, e uma mensagem de texto que receba uma resposta.
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.
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.
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"
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
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."
| 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. |
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."}]}'
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.
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.
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.
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.
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.