---
title: "Usa GPT in Hermes Agent tramite RunAPI — Guida API LLM"
url: "https://runapi.ai/it/hermes-gpt.md"
canonical: "https://runapi.ai/it/hermes-gpt"
locale: "it"
model: "gpt"
---

# Usa GPT in Hermes Agent.

GPT-5.5 è il modello LLM di punta di OpenAI, disponibile tramite RunAPI alla metà del prezzo ufficiale per token. Hermes Agent si connette tramite il provider custom:runapi usando la modalità chat_completions — un blocco di configurazione sblocca ogni variante GPT (5.5, 5.4, 5.4-mini, 5.3-codex) con streaming, chiamate a funzioni e output strutturato.

## API example

```bash
curl -X POST https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "You are a concise coding assistant."},
      {"role": "user", "content": "Write a Python function that merges two sorted lists in O(n) time."}
    ],
    "temperature": 0.3,
    "max_tokens": 1024
  }'

```

### Response

```json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "def merge_sorted(a, b):\n    result = []\n    i = j = 0\n    while i < len(a) and j < len(b):\n        if a[i] <= b[j]:\n            result.append(a[i]); i += 1\n        else:\n            result.append(b[j]); j += 1\n    result.extend(a[i:])\n    result.extend(b[j:])\n    return result"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 38,
    "completion_tokens": 95,
    "total_tokens": 133
  }
}

```

## How it works

1. **Aggiungi RunAPI come provider personalizzato** — Se il provider custom:runapi è già configurato in Hermes Agent, la stessa key funziona per GPT. Altrimenti, aggiungi un provider personalizzato con base_url https://runapi.ai/v1, key_env impostato su RUNAPI_API_KEY e api_mode impostato su chat_completions.
2. **Seleziona un modello GPT** — Imposta il modello predefinito su gpt-5.5 per il modello di punta, gpt-5.4 o gpt-5.4-mini per un costo inferiore, oppure gpt-5.3-codex per task intensivi di codice. L'endpoint /v1/chat/completions restituisce una risposta OpenAI standard con conteggi di utilizzo e finish_reason.
3. **Usa streaming o chiamate a funzioni** — Hermes Agent trasferisce i parametri stream, tools e response_format tramite il provider custom:runapi. Tutti i parametri standard OpenAI Chat Completions funzionano tramite RunAPI senza modifiche.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.4-nano, gpt-5.3-codex, o gpt-5.2. |
| `messages` | `array` | Obbligatorio. Array di oggetti messaggio con i campi role (system, user, assistant) e content. |
| `temperature` | `number` | Facoltativo. Temperatura di campionamento tra 0 e 2. Valori più bassi producono output più deterministico. Il valore predefinito è 1. |
| `max_tokens` | `integer` | Facoltativo. Numero massimo di token da generare nel completamento. |
| `stream` | `boolean` | Facoltativo. Se true, restituisce server-sent events con delta di token incrementali. Il valore predefinito è false. |
| `tools` | `array` | Facoltativo. Array di definizioni di strumenti per le chiamate a funzioni. Ogni strumento ha un tipo, un nome di funzione, una descrizione e uno schema di parametri. |
| `response_format` | `object` | Facoltativo. Imposta type su "json_object" o "json_schema" per l'output JSON strutturato. |
| `reasoning_effort` | `string` | Facoltativo. Controlla la profondità di ragionamento per i modelli supportati. I valori accettati sono low, medium, high. |

## FAQ

### Posso usare GPT-5.5 in Hermes Agent tramite RunAPI?

Sì. Hermes Agent supporta provider OpenAI-compatibili personalizzati. Aggiungi RunAPI come custom:runapi con base_url https://runapi.ai/v1, key_env impostato su RUNAPI_API_KEY e api_mode impostato su chat_completions. Imposta il modello predefinito su gpt-5.5.

### Come si confrontano i prezzi GPT di RunAPI con quelli ufficiali di OpenAI?

RunAPI addebita il 50% della tariffa ufficiale OpenAI per token per tutti i modelli GPT. Lo sconto si applica sia ai token di input che a quelli di output. Controlla la pagina dei prezzi di RunAPI per le tariffe esatte per milione di token.

### Posso passare tra varianti GPT senza riconfigurare il provider?

Sì. Il provider custom:runapi funziona con tutte le varianti GPT. Cambia solo il campo model nella tua richiesta — gpt-5.5, gpt-5.4, gpt-5.4-mini o gpt-5.3-codex. Il base URL, la API key e l'api_mode rimangono gli stessi.

### La Responses API funziona tramite RunAPI in Hermes Agent?

Sì. RunAPI fa da proxy anche alla OpenAI Responses API su /v1/responses. Se Hermes Agent supporta la superficie Responses API, imposta l'endpoint su https://runapi.ai/v1/responses. La stessa API key e lo stesso provider personalizzato funzionano per entrambi gli endpoint.

### Posso usare le chiamate a funzioni e l'output strutturato con GPT su RunAPI?

Sì. Passa un array tools per le chiamate a funzioni oppure imposta response_format su json_schema per l'output strutturato. RunAPI trasferisce questi parametri al modello GPT e restituisce i tool_calls o il JSON strutturato nel formato di risposta OpenAI standard.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [GPT su RunAPI →](https://runapi.ai/it/models/gpt)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)