Correggere GPT-5.6 non trovato in Codex

Quando GPT-5.6 fallisce in Codex, l'errore raramente ti dice cosa risolvere. La chiave potrebbe non esporre il modello, il percorso /v1 potrebbe essere errato o una richiesta di risposte dirette potrebbe funzionare mentre il provider rifiuta i metadati aggiunti da Codex. L'esecuzione ripetuta dello stesso comando in genere riproduce il sintomo; di per sé, non identifica lo strato difettoso.

Questo kit gratuito mette alla prova queste possibilità strato dopo strato. Verifica gli ID modello esatti, l'output delle risposte di base, un indicatore di testo SSE esatto e l'evento response.completed del terminale, nonché la funzione denominata con argomenti JSON esatti. Quindi esegue Codex con impostazioni temporanee del provider da una directory di lavoro vuota e scrive un report JSON ripulito. I controlli diretti inviano solo marcatori fissi; il test del fumo Codex lascia invariata la configurazione esistente. Il kit verifica la compatibilità; non definisce la qualità del modello.

Corrisponde all'errore GPT-5.6 prima di modificare la configurazione

Non incollare un errore in una soluzione alternativa di configurazione casuale. Un avviso diretto sui metadati del modello API 404, un avviso sui metadati del modello Codex e un messaggio del provider cooling down descrivono livelli diversi. I controlli seguenti preservano tale distinzione.

Cosa dimostra il kit

I controlli sono volutamente stratificati:

1. GET /v1/models conferma che la chiave può vedere ogni ID modello esatto.
2. Una chiamata di risposta minima non in streaming conferma la generazione di base e verifica l'ID del modello restituito.
3. Un controllo SSE richiede un indicatore di testo esatto e un evento terminale response.completed.
4. Un controllo rigoroso delle funzioni richiede la funzione denominata e gli argomenti esatti JSON.
5. Un'esecuzione codex exec isolata verifica lo Codex CLI installato tramite lo stesso provider.

Il passaggio di uno strato non implica il passaggio del successivo. Questa separazione è la parte utile: se i controlli diretti API superano e solo codex_cli_smoke fallisce, è improbabile che la modifica della chiave API o dell'ID modello risolva il problema reale.

Eseguilo senza toccare la configurazione esistente

Metti check.mjs e il launcher per la tua shell nella stessa directory. In Bash o Zsh, leggi la chiave senza inserire il suo valore letterale nella cronologia della shell:

chmod +x run.sh
printf 'OmniaKey API key: ' >&2
IFS= read -r -s OMNIAKEY_API_KEY
printf '\n' >&2
export OMNIAKEY_API_KEY
./run.sh
unset OMNIAKEY_API_KEY

Su Windows PowerShell:

$secureKey = Read-Host 'OmniaKey API key' -AsSecureString
$env:OMNIAKEY_API_KEY = [System.Net.NetworkCredential]::new('', $secureKey).Password
.\run.ps1
Remove-Item Env:OMNIAKEY_API_KEY
$secureKey = $null

L'esecuzione predefinita testa l'output delle risposte di base su Sol, Terra e Luna, quindi lo streaming, l'emissione di chiamate di funzione e Codex end-to-end su Sol. Si tratta di cinque generazioni dirette fisse più una svolta Codex isolata quando è installato Codex. L'utilizzo di API può essere fatturato anche se il kit è gratuito.

Utilizza --full per ripetere i controlli più approfonditi su tutti e tre i modelli. Ciò significa nove generazioni dirette e tre giri Codex. I tentativi diretti API ed entrambi i limiti di tentativi del provider Codex sono pari a zero; il kit non tenta di produrre uno 429. Se un modello ignora l'istruzione no-tool fissa e avvia un ciclo di strumenti, una svolta Codex può effettuare un'altra richiesta di modello e il rapporto lo contrassegna come non riuscito:

./run.sh --full

Per testare un modello senza richiamare Codex:

./run.sh --model gpt-5.6-terra --skip-codex

La chiave viene accettata solo tramite una variabile di ambiente e non è mai un argomento della riga di comando. I comandi di input silenziosi sopra mantengono il suo valore letterale fuori dalla cronologia della shell; come qualsiasi variabile d'ambiente del processo, può ancora essere ispezionata dai processi locali con permessi sufficienti mentre è impostata. Prima di scrivere il report, lo script cancella la chiave esatta più i moduli Bearer e sk-... comuni da ogni campo stringa controllato dal provider.

Ciò che registra il rapporto

Ogni report include la versione del kit, il timestamp UTC, l'origine dell'endpoint e il percorso di base, il sistema operativo, l'architettura, le versioni del nodo e Codex, i modelli selezionati, entrambi i valori di timeout e i limiti espliciti di zero tentativi. A seconda del livello e del risultato, i campi di controllo applicabili includono:

• ID modello richiesti e segnalati;
• stato superato, fallito o salta;
• Stato HTTP e intestazioni di risposta consentite per ID richiesta e limiti di velocità;
• ID di risposta e utilizzo del token quando l'endpoint li restituisce;
• tempo trascorso e il preciso motivo del mancato contratto o del salto;
• una categoria di errore normalizzata senza la chiave API o il corpo della risposta non elaborata.

Il file di output viene creato con autorizzazioni di solo proprietario sui sistemi POSIX. Gli ID richiesta non sono credenziali, ma esamina il report prima di condividerlo perché possono aiutare un fornitore a tracciare una richiesta.

Il codice di uscita 0 indica che ogni controllo eseguito è stato superato. 1 significa che almeno un controllo eseguito non è riuscito. 2 significa che gli argomenti, l'ambiente chiave, l'URL o un altro prerequisito non sono validi. Un'installazione Codex mancante viene segnalata come skip, non mascherata da errore API.

I fatti verificati su GPT-5.6

OpenAI attualmente documenta questi esatti ID e ruoli API:

L'alias gpt-5.6 attualmente indirizza a gpt-5.6-sol. Per la diagnostica, utilizzare gli ID espliciti: un alias aggiunge una domanda di instradamento di cui il test di compatibilità non ha bisogno.

Le tre pagine del modello corrente elencano tutte una finestra di contesto API del token 1,050,000, l'input massimo 922,000, l'output massimo 128,000 e un limite di conoscenza 2026-02-16. Vengono inoltre elencati le risposte, Chat Completions e il supporto batch, oltre allo streaming, agli output strutturati e alle chiamate di funzioni. Vedi le pagine principali di Sol, Terra e Luna.

Questi sono i limiti del modello API, non una promessa che ogni configurazione del client Codex esponga l'intera finestra. Codex dispone di un proprio catalogo modelli, model_context_window, e di un comportamento di compattazione automatico. Questo kit non invia un prompt da un milione di token né deduce una finestra Codex effettiva dal titolo API.

Una configurazione minima del provider Codex

L'attuale configurazione Codex utilizza uno ~/.codex/config.toml a livello utente per i provider personalizzati. Il riferimento alla configurazione corrente elenca responses come valore wire_api supportato. Un esempio minimo di OmniaKey è:

model = "gpt-5.6-sol"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"

env_key e requires_openai_auth sono modalità di autenticazione alternative. L'attuale documentazione di autenticazione Codex afferma che requires_openai_auth = true fa sì che Codex ignori env_key; non aggiungerlo a questo blocco del provider.

Eseguire il backup di una configurazione reale prima di modificarla:

cp ~/.codex/config.toml ~/.codex/config.toml.before-gpt56

Equivalente di PowerShell:

Copy-Item "$HOME\.codex\config.toml" "$HOME\.codex\config.toml.before-gpt56"

Il controllo compatibilità non richiede la modifica del file o l'utilizzo delle impostazioni del provider. Il suo test del fumo Codex ignora la configurazione dell'utente, crea un CODEX_HOME temporaneo, passa le impostazioni del provider solo a quel processo, utilizza una directory di lavoro vuota e un sandbox di sola lettura, quindi rimuove la directory. Passa solo la chiave più una lista consentita di variabili di runtime, impostazioni locali, directory temporanea, proxy e ambiente TLS; il rapporto registra i loro nomi, mai i loro valori.

Il sandboxing di sola lettura impedisce le scritture, non tutte le letture possibili. Viene selezionata la richiesta fissa di assenza di strumenti, ma non si tratta di un limite di sicurezza rigido. Utilizzare --skip-codex o eseguire il kit all'interno di un contenitore isolato o di una VM se la macchina dispone di file che il processo Codex non deve essere in grado di leggere.

Consultare il riferimento alla configurazione Codex e la guida all'agente di codifica OmniaKey prima di apportare modifiche permanenti. Per decidere sul prodotto anziché per la risoluzione dei problemi, leggi il confronto tra Claude Code e Codex.

Se Codex è già stato scelto e la decisione è Sole, Terra o Luna, utilizza la guida al modello GPT-5.6 per Codex.

Per informazioni più generali sulla famiglia e sui prezzi ufficiali di API, consulta la recensione GPT-5.6; questo kit rimane focalizzato sulla risoluzione dei problemi di compatibilità.

Leggi i fallimenti per livello, non per supposizioni

Non comprimere 401 e 403 nella stessa diagnosi. Un 401 normalmente punta all'autenticazione; un 403 può significare che un'identità valida non dispone dell'autorizzazione. Allo stesso modo, uno 404 può essere un percorso base /v1 errato o un percorso valido con un modello non disponibile.

La guida agli errori di OpenAI consiglia di controllare la forma della richiesta per individuare eventuali richieste errate, pacing delle chiamate per i limiti di velocità e riprovare brevemente gli errori del server. Questo kit lascia intenzionalmente all'utente i tentativi in ​​modo che il primo errore rimanga visibile.

L'attuale trappola del provider personalizzato

Due report Codex aperti, #31870 e #31882, documentano gli errori GPT-5.6 tramite provider Azure/personalizzati su Codex 0.144.x. Nei casi segnalati, le chiamate a risposta diretta hanno avuto esito positivo mentre le richieste Codex non sono riuscite con errori 400 che menzionavano X-OpenAI-Internal-Codex-Responses-Lite o lo spazio dei nomi collaboration riservato.

Questi problemi sono segnalazioni sul campo, non la prova che ogni provider personalizzato fallisce. Sono esattamente il motivo per cui il kit funziona direttamente e gli strati Codex separatamente.

Se il tuo rapporto mostra questa suddivisione:

1. Registra codex_version, la categoria di errore esatta e l'ID della richiesta.
2. Aggiorna all'ultima versione stabile Codex ed esegui nuovamente la stessa versione del kit.
3. Controlla se i due problemi sono ancora aperti e se un manutentore ha pubblicato una correzione.
4. Invia il report ripulito al tuo fornitore o al supporto Codex se l'errore persiste.

Il problema n. 31882 descrive un override completo del catalogo di modelli che disabilita Responses-Lite e i metadati multi-agente. È fragile: l'override sostituisce i metadati del catalogo, può spostarsi dopo un aggiornamento e disattivare il comportamento su cui fai affidamento. La versione 1.0.0 di questo kit rileva le firme degli errori segnalati ma deliberatamente non applica la patch Codex né consiglia un downgrade silenzioso.

Ciò che questo kit non misura

Questa è una sonda di compatibilità, non un benchmark di qualità del modello. Non mette a confronto l'accuratezza della codifica, il comportamento a lungo contesto, il tasso di utilizzo della cache, la latenza di produzione, i tempi di svuotamento SSE progressivi, il prezzo fatturato, l'input di immagini, gli strumenti ospitati, il lavoro multi-agente o un ciclo completo di continuazione delle chiamate di funzione. Un report verde significa che i contratti testati hanno funzionato una volta con le versioni e l'endpoint registrati. Non prevede ogni carico di lavoro né fornisce l'isolamento del file system a livello di processo.

Per motivi di riproducibilità, conservare il report generato e i file esatti del kit. Verifica i download con SHA256SUMS, esegui nuovamente dopo un Codex o un cambio di provider e confronta i singoli controlli anziché solo lo stato finale.

Domande frequenti

Perché Codex dice che i metadati del modello non sono stati trovati?

Codex non è riuscito a far corrispondere il modello selezionato ai metadati del catalogo ed è tornato a valori generici. Controlla se una richiesta di risposta diretta funziona prima di modificare le credenziali. Se solo Codex fallisce, registrare la versione Codex ed eseguire il controllo CLI isolato.

Perché ricevo un modello non trovato o un 404 per GPT-5.6 Sol?

Conferma che l'URL di base termina con /v1, quindi controlla GET /v1/models per l'esatto ID minuscolo gpt-5.6-sol. Una chiave valida non garantisce l'accesso a ogni modello.

Perché GPT-5.6 non è disponibile con il mio login ChatGPT Codex?

Codex autenticato da ChatGPT e una chiave API tramite un provider personalizzato sono percorsi di accesso separati. La disponibilità in uno non dimostra la disponibilità nell'altro.

Devo riprovare un errore di raffreddamento di tutte le credenziali?

Seguire il segnale di nuovo tentativo o ripristino del provider. I tentativi immediati ripetuti non risolvono un pool di credenziali esaurito e possono aggiungere ulteriore carico.

Quando dovrei eseguire il kit di compatibilità?

Eseguirlo quando il messaggio da solo non identifica se l'accesso al modello, Responses API o Codex non funziona. Conserva il report disinfettato quando hai bisogno del supporto del fornitore o di Codex.

Fonti controllate

• Utilizzando GPT-5.6
• Modelli GPT-5.6 in Codex
• Pagina modello GPT-5.6 Sol
• Pagina modello GPT-5.6 Terra
• Pagina modello GPT-5.6 Luna
• Riferimento configurazione Codex
• Autenticazione Codex per fornitori alternativi
• Guida agli errori OpenAI API
• Codex problema #31870 e #31882, entrambi aperti quando selezionati