---
title: Usa RunAPI in DeepSeek Harness — Guida a Custom model API | RunAPI
description: Configura DeepSeek Harness (dsh) con RunAPI come Custom model API tramite OpenAI Chat Completions, conserva la chiave in RUNAPI_API_KEY e invia un primo messaggio di testo con gpt-5.4-nano.
url: https://runapi.ai/it/dsh.md
canonical: https://runapi.ai/it/dsh
locale: it
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/dsh
  zh-CN: https://runapi.ai/zh-CN/dsh
  es: https://runapi.ai/es/dsh
  ja: https://runapi.ai/ja/dsh
  de: https://runapi.ai/de/dsh
  fr: https://runapi.ai/fr/dsh
  pt-BR: https://runapi.ai/pt-BR/dsh
  ko: https://runapi.ai/ko/dsh
  it: https://runapi.ai/it/dsh
  nl: https://runapi.ai/nl/dsh
  pl: https://runapi.ai/pl/dsh
  tr: https://runapi.ai/tr/dsh
  zh-TW: https://runapi.ai/zh-TW/dsh
  zh-HK: https://runapi.ai/zh-HK/dsh
  ar: https://runapi.ai/ar/dsh
  x-default: https://runapi.ai/dsh
---

> HTML version: https://runapi.ai/it/dsh
> Site index for agents: https://runapi.ai/llms.txt


# 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.

- [Ottieni una chiave API](https://runapi.ai/it/login)
- [Esplora i modelli](https://runapi.ai/it/models.md)

> Verificato con dsh 0.2.1-rc.2 su uno stub locale · nessuna chiamata a pagamento al fornitore a monte

## 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.

## runapi.patch.yml

```yaml
- 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
```

## Comandi

```bash
export RUNAPI_API_KEY="runapi_xxx"
npx @deepseek-ai/dsh@0.2.1-rc.2 --version
npx @deepseek-ai/dsh@0.2.1-rc.2 headless --patch runapi.patch.yml "Reply with one short sentence."
npx @deepseek-ai/dsh@0.2.1-rc.2 web --patch runapi.patch.yml
```

## 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/dsh@0.2.1-rc.2 headless --patch runapi.patch.yml "Reply with one short sentence."`

## 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 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.

```bash
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."}]}'
```

## 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.

## Fonti ufficiali

- [DeepSeek Harness model configuration](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/providers.md#add-a-custom-model-api)
- [DeepSeek Harness README](https://github.com/deepseek-ai/deepseek-harness#run)

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


---

## More from RunAPI

- [Home](https://runapi.ai/it/.md)
### Prodotto
- [Catalogo dei modelli](https://runapi.ai/it/models.md)
- [Prezzi](https://runapi.ai/it/pricing.md)
- [Fornitori](https://runapi.ai/it/models#all-models)
### Sviluppatori
- [Documentazione](https://runapi.ai/it/docs/guides)
- [SDK](https://runapi.ai/it/sdk.md)
- [CLI](https://runapi.ai/it/cli.md)
- [MCP Server](https://runapi.ai/it/mcp.md)
- [x402](https://runapi.ai/it/x402.md)
### Guide
- [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md)
- [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md)
### Azienda
- [Enterprise](https://runapi.ai/it/contact.md)
- [Contatti](https://runapi.ai/it/contact.md)
### Legale
- [Termini](https://runapi.ai/it/terms.md)
- [Privacy](https://runapi.ai/it/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/iticon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "SoftwareApplication",
    "name": "RunAPI for DeepSeek Harness",
    "applicationCategory": "DeveloperApplication",
    "description": "Configura DeepSeek Harness (dsh) con RunAPI come Custom model API tramite OpenAI Chat Completions, conserva la chiave in RUNAPI_API_KEY e invia un primo messaggio di testo con gpt-5.4-nano.",
    "url": "https://runapi.ai/it/dsh"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "dsh si arresta con MISSING_CREDENTIAL. Cosa manca?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "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."
        }
      },
      {
        "@type": "Question",
        "name": "dsh segnala un errore 404 o di connessione. L’URL di base è errato?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "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."
        }
      },
      {
        "@type": "Question",
        "name": "dsh segnala 404 Resource not found con l’URL corretto. Cosa devo controllare?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "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."
        }
      },
      {
        "@type": "Question",
        "name": "Serve un plugin nativo del fornitore RunAPI?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "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."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "HowTo",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "Esporta la chiave RunAPI",
        "text": "Imposta RUNAPI_API_KEY nella shell che avvia dsh. La patch legge la chiave dall’ambiente, quindi non viene mai salvata in un file."
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "Aggiungi Custom model API",
        "text": "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."
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "Invia un messaggio di testo",
        "text": "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."
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://runapi.ai/it"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "RunAPI for DeepSeek Harness",
        "item": "https://runapi.ai/it/dsh"
      }
    ]
  }
]
```
