logo
Guida all'integrazione del modello di testo

Scegli prima un protocollo, poi copia la configurazione completa per il tuo client.

Non devi capire ogni API. Scegli Responses, Messages o Chat — i protocolli attualmente supportati da AIReiter — quindi copia una configurazione verificata rispetto alla documentazione ufficiale o al codice di questo progetto.

Inizia configurazioneCrea chiave APIDocumentazione per sviluppatori
Confronto prezziI modelli GPT-5.6 hanno un prezzo pari al 50% delle tariffe API ufficiali

Prezzo API ufficiale vs prezzo AIReiter

Tutti i prezzi sono per 1M token. AIReiter è attualmente impostato a metà della tariffa ufficiale GPT-5.6, includendo input normale, output, input memorizzato nella cache e scritture nella cache.

50%

Il prezzo AIReiter è la metà del prezzo API ufficiale in entrambe le fasce di contesto e in tutti i bucket di fatturazione della cache.

ModelloLivello di contestoInputOutputLettura cacheScrittura cache
GPT-5.6 LunaContesto < 272K
Ufficiale$1.00AIReiter$0.50
Ufficiale$6.00AIReiter$3.00
Ufficiale$0.10AIReiter$0.05
Ufficiale$1.25AIReiter$0.625
GPT-5.6 LunaContesto >= 272K
Ufficiale$2.00AIReiter$1.00
Ufficiale$9.00AIReiter$4.50
Ufficiale$0.20AIReiter$0.10
Ufficiale$2.50AIReiter$1.25
GPT-5.6 TerraContesto < 272K
Ufficiale$2.50AIReiter$1.25
Ufficiale$15.00AIReiter$7.50
Ufficiale$0.25AIReiter$0.125
Ufficiale$3.125AIReiter$1.5625
GPT-5.6 TerraContesto >= 272K
Ufficiale$5.00AIReiter$2.50
Ufficiale$22.50AIReiter$11.25
Ufficiale$0.50AIReiter$0.25
Ufficiale$6.25AIReiter$3.125
GPT-5.6 SolContesto < 272K
Ufficiale$5.00AIReiter$2.50
Ufficiale$30.00AIReiter$15.00
Ufficiale$0.50AIReiter$0.25
Ufficiale$6.25AIReiter$3.125
GPT-5.6 SolContesto >= 272K
Ufficiale$10.00AIReiter$5.00
Ufficiale$45.00AIReiter$22.50
Ufficiale$1.00AIReiter$0.50
Ufficiale$12.50AIReiter$6.25

Come la fatturazione corrisponde all'upstream

Il livello viene scelto in base alla lunghezza totale del contesto di input. I token memorizzati nella cache usano i prezzi di lettura o scrittura della cache quando l'upstream segnala cached_tokens o cache_write_tokens; altrimenti si applicano i normali prezzi di input e output.

Protocollo Responses/api/v1/responses

Codex CLI

Strumenti come Codex CLI funzionano meglio con Responses. I punti chiave: base_url si ferma a /api/v1 e wire_api è impostato su responses, con la chiave letta dalla variabile di ambiente indicata da env_key.

OpenAI ufficialeVisualizza sorgente

I campi model_providers / base_url / wire_api / env_key provengono dalla documentazione ufficiale Advanced Configuration di Codex; anche che env_key debba puntare a una variabile d'ambiente e che requires_openai_auth disabiliti env_key sono affermazioni ufficiali. Nota che wire_api accetta solo responses a partire da Codex 0.59.

URL base del client

https://aireiter.com/api/v1

Percorso aggiunto dal client

/responses

URL finale della richiesta

https://aireiter.com/api/v1/responses

Modello di esempio

gpt-5.6-luna

1

1. Scrivi config.toml

Posizione del file: ~/.codex/config.toml. base_url deve fermarsi a /api/v1; Codex chiama /responses in base a wire_api = "responses". env_key punta a un nome di variabile d'ambiente — non inserire mai la chiave reale nel TOML e non aggiungere requires_openai_auth = true: con questa opzione Codex ignora env_key e richiede invece l'accesso ufficiale a OpenAI.

Pronto per la copia
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
2

2. Esporta la variabile d'ambiente della chiave API

Codex legge la chiave dalla variabile d'ambiente chiamata da env_key all'avvio. Scrivila nel profilo della tua shell in modo che persista; non committare mai la chiave reale in un repository.

Pronto per la copia
echo 'export AIREITER_API_KEY="sk-sostituisci-con-la-tua-chiave"' >> ~/.zshrc
source ~/.zshrc
3

3. configurazione one-shot per macOS / Linux

Entrambi i passaggi uniti in un unico blocco che puoi incollare ed eseguire. Se hai già un config.toml, uniscilo manualmente per evitare di sovrascrivere altri provider.

Pronto per la copia
mkdir -p "$HOME/.codex"

cat > "$HOME/.codex/config.toml" <<EOF
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
EOF

echo 'export AIREITER_API_KEY="sk-sostituisci-con-la-tua-chiave"' >> ~/.zshrc
source ~/.zshrc
4

4. configurazione one-shot per Windows PowerShell

Gli utenti Windows copino questo blocco. setx scrive una variabile d'ambiente a livello utente; apri una nuova finestra del terminale perché abbia effetto.

Pronto per la copia
$configDir = "$env:USERPROFILE\.codex"
New-Item -Path $configDir -ItemType Directory -Force | Out-Null

@"
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
"@ | Set-Content -Path "$configDir\config.toml"

setx AIREITER_API_KEY "sk-sostituisci-con-la-tua-chiave"
5

5. Controllo di connettività

Richiedi prima l'elenco dei modelli. Avvia Codex solo dopo aver ottenuto indietro un elenco JSON — il troubleshooting diventa molto più semplice.

Pronto per la copia
curl -sS -i "https://aireiter.com/api/v1/models" \
  -H "Authorization: Bearer $AIREITER_API_KEY" | head -n 20
6

6. Avvia Codex

Avvia dopo essere entrato nella directory del tuo progetto. L'output in streaming significa che l'integrazione Responses funziona.

Pronto per la copia
cd ~/your-project
codex
7

Promemoria dei codici di stato

Quando gli utenti segnalano errori, controlla prima il codice di stato, poi base_url e la chiave.

Pronto per la copia
HTTP 200  La configurazione è corretta, avvia il tuo client
HTTP 401  La chiave è sbagliata o mancante, ricopia la tua chiave API
HTTP 403  La chiave non ha accesso a questo modello, controlla i permessi dell'account o del modello
HTTP 404  URL sbagliato, verifica prima se base_url ha /api/v1 in più o mancante
HTML restituito  La richiesta ha raggiunto il frontend del sito web, base_url è sbagliato
HTTP 502/504  Problema del gateway o upstream, riprova più tardi
Riferimento rapido per client di terze partiTutti i campi di configurazione provengono dalla documentazione ufficiale di ciascun client

Quale endpoint per CC Switch o OpenClaw?

Sono client che trasportano un protocollo, non protocolli essi stessi: fornisci agli strumenti in stile Claude Code l'indirizzo in stile Anthropic, e agli strumenti compatibili con OpenAI /api/v1. Le guide complete passo per passo si trovano sotto il protocollo corrispondente qui sopra.

CC Switch

Nella scheda Claude Code imposta la base URL del provider su https://aireiter.com/api — guida sotto "Messages protocol → CC Switch (GUI)". Nella scheda Codex usa https://aireiter.com/api/v1 — guida sotto "Responses protocol → CC Switch (GUI)".

OpenClaw

Con api: "openai-completions" imposta baseUrl su https://aireiter.com/api/v1; con api: "anthropic-messages" usa https://aireiter.com/api. Guida passo per passo sotto "Chat protocol → OpenClaw".

Allineamento di settoreCome i gateway compatibili con OpenAI scrivono baseURL

Non confondere la base URL con la URL finale.

I gateway per modelli di testo come OpenRouter, Groq e Together hanno tutti la baseURL/base_url dell'SDK che si ferma a /v1, con il metodo SDK che aggiunge /chat/completions. Questa pagina li separa nello stesso modo: base URL del client, percorso aggiunto dal client e URL finale della richiesta sono mostrati separatamente.

OpenRouter

Gateway compatibile con OpenAI; la base URL dell'SDK si ferma a /api/v1.

Groq

Anche la sua documentazione compatibile con OpenAI sottolinea di sostituire la base URL, non di inserire l'endpoint completo in baseURL.

Together AI

Compatibile anche con OpenAI-SDK — stessa combinazione di base URL + percorso del metodo SDK.

Esiste count_tokens?

Sì, in /api/v1/messages/count_tokens. Esegue solo il conteggio dei token di Anthropic — non è un endpoint di generazione.

Le fonti sono affidabili?

Le configurazioni pronte da copiare includono solo ciò che la documentazione ufficiale, i protocolli OpenAI/Anthropic o il codice di questo progetto possono verificare; i client di terze parti ricevono solo note di compatibilità.

Quale dovrebbero scegliere i principianti?

Codex → Responses; Claude Code → Messages; SDK OpenAI e client generici compatibili con OpenAI → Chat; se preferisci non modificare i file di configurazione, usa la GUI CC Switch.