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.
Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.
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.
- 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
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.
Un fornitore Custom model API chiamato runapi, un modello, gpt-5.4-nano, e un messaggio di testo che riceve una risposta.
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.
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.
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"
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
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."
| 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. |
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."}]}'
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.
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.
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.
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.
Crea un account RunAPI o accedi, crea una chiave API ed esportala come RUNAPI_API_KEY prima di avviare dsh.