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 in DeepSeek Harness.

Aggiungi RunAPI come Custom model API in dsh, imposta https://runapi.ai/v1 tramite OpenAI Chat Completions e conversa con gpt-5.4-nano dall’interfaccia web o in modalità headless.

Verificato con dsh 0.2.1-rc.2 su uno stub locale · nessuna chiamata a pagamento al fornitore a monte
- 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
Verificato con dsh 0.2.1-rc.2/v1
AMBITO

Un modello, una chat di testo

Obiettivo

Consentire agli utenti di DeepSeek Harness di instradare le richieste di chat tramite RunAPI con il proprio URL di base e la propria chiave API, senza un plugin nativo del fornitore.

Configurazione minima funzionante

Un fornitore Custom model API chiamato runapi, un modello, gpt-5.4-nano, e un messaggio di testo che riceve una risposta.

Versione fissata

La configurazione e i comandi sono stati verificati con @deepseek-ai/dsh 0.2.1-rc.2. Fissa questa versione con npx finché non avrai verificato personalmente una versione più recente.

Verifica senza chiamate a pagamento

Il caricamento di dsh, il formato delle richieste, le risposte e i messaggi di errore sono stati verificati su uno stub locale dell’endpoint RunAPI. Per questa pagina non è stata effettuata alcuna richiesta a pagamento a un fornitore a monte.

CONFIGURAZIONE

Collega dsh a RunAPI in tre passaggi

1

Esporta la chiave RunAPI

Imposta RUNAPI_API_KEY nella shell che avvia dsh. La patch legge la chiave dall’ambiente, quindi non viene mai salvata in un file.

export RUNAPI_API_KEY="runapi_xxx"
2

Aggiungi Custom model API

Salva runapi.patch.yml per --patch oppure aggiungi i valori in Settings → Models → Add model provider → Custom model API. L’interfaccia salva un proprio profilo e la chiave nell’archivio delle credenziali; --patch rende questi campi di Settings di sola lettura.

api: openai-completions
3

Invia un messaggio di testo

Esegui un’attività headless oppure apri l’interfaccia web con la patch. Nell’interfaccia, seleziona runapi/gpt-5.4-nano nel selettore dei modelli prima di chattare. Una risposta nel terminale o nella chat indica che dsh ha raggiunto RunAPI.

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

Campi di Custom model API

Campo Valore Scopo
ID del fornitore runapi ID permanente usato da sessioni, impostazioni predefinite e riferimento alle credenziali.
URL di base https://runapi.ai/v1 Invia le richieste all’endpoint di RunAPI compatibile con OpenAI.
Protocollo API openai-completions OpenAI Chat Completions, che RunAPI offre su /v1/chat/completions.
Credenziale RUNAPI_API_KEY Letta dall’ambiente con apiKeyEnv oppure salvata tramite la pagina Models.
Modello gpt-5.4-nano Modello di testo sincrono a basso costo nel catalogo RunAPI.
VERIFICA DELLA CHAT

Verifica chiave e modello prima di usare dsh

Questa richiesta sincrona usa lo stesso URL di base, la stessa chiave e lo stesso modello della patch e limita la risposta a 64 token. Se restituisce un messaggio, un errore di dsh dipende dalla configurazione di dsh, non dall’account 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."}]}'
RISOLUZIONE DEI PROBLEMI

Errori di DeepSeek Harness

dsh si arresta con MISSING_CREDENTIAL. Cosa manca?

RUNAPI_API_KEY non è impostata nella shell che ha avviato dsh. Esportala oppure salva la chiave nella pagina Models, quindi esegui di nuovo lo stesso comando.

dsh segnala un errore 404 o di connessione. L’URL di base è errato?

Di solito sì. L’URL di base deve essere esattamente https://runapi.ai/v1; dsh aggiunge /chat/completions autonomamente. Un errore di connessione indica che non è stato possibile raggiungere l’host.

dsh segnala 404 Resource not found con l’URL corretto. Cosa devo controllare?

Verifica l’ID del modello nel catalogo dei modelli RunAPI, ad esempio gpt-5.4-nano, e controlla che agent-default-model usi il fornitore runapi e l’ID del modello corrispondenti.

Serve un plugin nativo del fornitore RunAPI?

No. dsh include il supporto Custom model API per OpenAI Chat Completions e RunAPI offre questo protocollo, quindi la patch è sufficiente per la chat di testo.

Ottieni una chiave RunAPI per dsh.

Crea un account RunAPI o accedi, crea una chiave API ed esportala come RUNAPI_API_KEY prima di avviare dsh.