Corrigir GPT-5.6 não encontrado no Codex

Quando GPT-5.6 falha em Codex, o erro raramente informa o que corrigir. A chave pode não expor o modelo, a rota /v1 pode estar errada ou uma solicitação de Respostas direta pode funcionar enquanto o provedor rejeita metadados adicionados por Codex. Executar o mesmo comando novamente geralmente reproduz o sintoma; por si só, não identifica a camada com falha.

Este kit gratuito testa essas possibilidades camada por camada. Ele verifica os IDs exatos do modelo, a saída de respostas básicas, um marcador de texto SSE exato e um evento de terminal response.completed e a função nomeada com argumentos JSON exatos. Em seguida, ele executa Codex com configurações de provedor temporárias a partir de um diretório de trabalho vazio e grava um relatório JSON limpo. As verificações diretas enviam apenas marcadores fixos; o teste de fumaça Codex deixa sua configuração existente inalterada. O kit verifica a compatibilidade; não avalia a qualidade do modelo.

Combine o erro GPT-5.6 antes de alterar a configuração

Não cole um erro em uma solução alternativa de configuração aleatória. Um aviso direto de metadados API 404, um aviso de metadados do modelo Codex e uma mensagem do provedor cooling down descrevem diferentes camadas. As verificações abaixo preservam essa distinção.

O que o kit prova

As verificações são deliberadamente dispostas em camadas:

1. GET /v1/models confirma que a chave pode ver cada ID exata do modelo.
2. Uma chamada mínima de respostas sem streaming confirma a geração básica e verifica o ID do modelo retornado.
3. Uma verificação SSE requer um marcador de texto exato e um evento de terminal response.completed.
4. Uma verificação estrita de função requer a função nomeada e os argumentos JSON exatos.
5. Uma execução isolada do codex exec testa o Codex CLI instalado por meio do mesmo provedor.

Passar uma camada não implica que a próxima passe. Essa separação é a parte útil: se as verificações diretas do API forem aprovadas e apenas o codex_cli_smoke falhar, é improvável que a alteração da chave API ou do ID do modelo resolva o problema real.

Execute-o sem alterar sua configuração existente

Coloque check.mjs e o inicializador do seu shell no mesmo diretório. No Bash ou Zsh, leia a chave sem colocar seu valor literal no histórico do 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

No 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

A execução padrão testa a saída de respostas básicas em Sol, Terra e Luna, depois streaming, emissão de chamada de função e Codex de ponta a ponta em Sol. São cinco gerações diretas fixas mais um giro Codex isolado quando o Codex é instalado. O uso do API pode ser cobrado mesmo que o kit seja gratuito.

Use --full para repetir as verificações mais profundas em todos os três modelos. Isso perfaz nove gerações diretas e três voltas Codex. Novas tentativas diretas de API e ambos os limites de novas tentativas do provedor Codex são zero; o kit não tenta fabricar um 429. Se um modelo ignorar a instrução fixa de não ferramenta e iniciar um loop de ferramenta, um giro Codex pode fazer outra solicitação de modelo e o relatório marca-o como falhado:

./run.sh --full

Para testar um modelo sem invocar Codex:

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

A chave é aceita apenas por meio de uma variável de ambiente e nunca é um argumento de linha de comando. Os comandos de entrada silenciosos acima mantêm seu valor literal fora do histórico do shell; como qualquer variável de ambiente de processo, ela ainda pode ser inspecionada por processos locais com permissão suficiente enquanto estiver definida. Antes de escrever o relatório, o script redige a chave exata e os formulários Bearer e sk-... comuns de cada campo de string controlado pelo provedor.

O que o relatório registra

Cada relatório inclui a versão do kit, carimbo de data/hora UTC, origem do endpoint e caminho base, sistema operacional, arquitetura, versões do Node e Codex, modelos selecionados, ambos os valores de tempo limite e os limites explícitos de zero nova tentativa. Dependendo da camada e do resultado, os campos de verificação aplicáveis incluem:

• IDs de modelo solicitados e relatados;
• status de aprovado, reprovado ou ignorado;
• Status HTTP e cabeçalhos de resposta permitidos para IDs de solicitação e limites de taxa;
• ID de resposta e uso de token quando o endpoint os retorna;
• tempo decorrido e o motivo exato da falha no contrato ou da falha;
• uma categoria de erro normalizada sem a chave API ou corpo de resposta bruto.

O arquivo de saída é criado com permissões somente de proprietário em sistemas POSIX. Os IDs de solicitação não são credenciais, mas revise o relatório antes de compartilhá-lo, pois eles podem ajudar um provedor a rastrear uma solicitação.

O código de saída 0 significa que todas as verificações executadas foram aprovadas. 1 significa que pelo menos uma verificação executada falhou. 2 significa que os argumentos, ambiente chave, URL ou outro pré-requisito eram inválidos. Uma instalação Codex ausente é relatada como skip, não disfarçada como uma falha API.

Os fatos verificados do GPT-5.6

OpenAI atualmente documenta esses IDs e funções API exatos:

O alias gpt-5.6 atualmente é roteado para gpt-5.6-sol. Para diagnósticos, use os IDs explícitos: um alias adiciona uma pergunta de roteamento que o teste de compatibilidade não precisa.

Todas as três páginas do modelo atual listam uma janela de contexto 1,050,000 do token API, entrada máxima 922,000, saída máxima 128,000 e um corte de conhecimento 2026-02-16. Eles também listam respostas, Chat Completions e suporte a lote, além de streaming, saídas estruturadas e chamadas de função. Veja as páginas principais de Sol, Terra e Luna.

Esses são limites do modelo API, não uma promessa de que cada configuração do cliente Codex expõe a janela completa. Codex possui seu próprio catálogo de modelos, model_context_window, e comportamento de compactação automática. Este kit não envia um prompt de um milhão de tokens nem infere uma janela Codex efetiva a partir do título API.

Uma configuração mínima do provedor Codex

A configuração atual do Codex usa um ~/.codex/config.toml de nível de usuário para provedores personalizados. A referência de configuração atual lista responses como o valor wire_api suportado. Um exemplo mínimo de 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 são modos de autenticação alternativos. Atual documentação de autenticação Codex diz que requires_openai_auth = true faz Codex ignorar env_key; não o adicione a este bloco de provedor.

Faça backup de uma configuração real antes de editá-la:

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

Equivalente do PowerShell:

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

O verificador de compatibilidade não exige que você edite esse arquivo ou use as configurações do provedor. Seu teste de fumaça Codex ignora a configuração do usuário, cria um CODEX_HOME temporário, passa as configurações do provedor apenas para esse processo, usa um diretório de trabalho vazio e uma sandbox somente leitura e, em seguida, remove o diretório. Ele passa apenas a chave mais uma lista de permissões de tempo de execução, localidade, diretório temporário, proxy e variáveis ​​de ambiente TLS; o relatório registra seus nomes, nunca seus valores.

O sandbox somente leitura evita gravações, nem todas as leituras possíveis. O prompt fixo sem ferramenta é verificado, mas não é um limite rígido de segurança. Use --skip-codex ou execute o kit dentro de um contêiner isolado ou VM se a máquina tiver arquivos que o processo Codex não deve ser capaz de ler.

Consulte a referência de configuração Codex e o guia do agente de codificação OmniaKey antes de fazer alterações permanentes. Para decidir sobre o produto, em vez de solucionar problemas, leia a comparação Claude Code vs Codex.

Se Codex já estiver escolhido e a decisão for Sol, Terra ou Luna, use o guia de modelo GPT-5.6 para Codex.

Para informações mais amplas sobre a família e preços oficiais do API, consulte a análise do GPT-5.6; este kit permanece focado na solução de problemas de compatibilidade.

Leia as falhas por camada, não por suposições

Não recolha 401 e 403 no mesmo diagnóstico. Um 401 normalmente aponta para autenticação; um 403 pode significar que uma identidade válida não tem permissão. Da mesma forma, um 404 pode ser um caminho base /v1 errado ou um caminho válido com um modelo indisponível.

O [guia de erros] OpenAI de (https://developers.openai.com/api/docs/guides/error-codes) recomenda verificar o formato da solicitação em busca de solicitações incorretas, controlar o ritmo das chamadas para limites de taxa e tentar novamente brevemente os erros do servidor. Este kit deixa tentativas intencionalmente para você, para que a primeira falha permaneça visível.

A armadilha atual do provedor personalizado

Dois relatórios Codex abertos, #31870 e #31882, documentam falhas de GPT-5.6 por meio de provedores Azure/personalizados em Codex 0.144.x. Nos casos relatados, as chamadas de respostas diretas foram bem-sucedidas enquanto as solicitações Codex falharam com erros 400 mencionando X-OpenAI-Internal-Codex-Responses-Lite ou o namespace collaboration reservado.

Esses problemas são relatórios de campo e não prova de que todo provedor personalizado falha. É exatamente por isso que o kit executa camadas diretas e Codex separadamente.

Se o seu relatório mostrar essa divisão:

1. Registre codex_version, a categoria exata do erro e o ID da solicitação.
2. Atualize para a versão estável mais recente do Codex e execute novamente a mesma versão do kit.
3. Verifique se os dois problemas ainda estão abertos e se um mantenedor publicou uma correção.
4. Envie o relatório limpo ao seu provedor ou ao suporte Codex se a falha persistir.

O problema #31882 descreve uma substituição completa do catálogo de modelos que desativa os metadados do Responses-Lite e de vários agentes. É frágil: a substituição substitui os metadados do catálogo, pode variar após uma atualização e desabilitar o comportamento no qual você confia. A versão 1.0.0 deste kit detecta as assinaturas de falha relatadas, mas deliberadamente não corrige Codex nem recomenda um downgrade silencioso.

O que este kit não mede

Esta é uma investigação de compatibilidade, não um benchmark de qualidade do modelo. Ele não compara a precisão da codificação, o comportamento de longo contexto, a taxa de acertos do cache, a latência de produção, o tempo de liberação progressiva do SSE, o preço faturado, a entrada de imagem, as ferramentas hospedadas, o trabalho multiagente ou um loop completo de continuação de chamada de função. Um relatório verde significa que os contratos testados funcionaram uma vez com as versões registradas e o endpoint. Ele não prevê todas as cargas de trabalho nem fornece isolamento do sistema de arquivos em nível de processo.

Para reprodutibilidade, guarde o relatório gerado e os arquivos exatos do kit. Verifique downloads com SHA256SUMS, execute novamente após um Codex ou mudança de provedor e compare verificações individuais em vez de apenas o status final.

Perguntas frequentes

Por que Codex diz que os metadados do modelo não foram encontrados?

Codex não pôde corresponder ao modelo selecionado para catalogar metadados e retornou para valores genéricos. Verifique se uma solicitação de respostas diretas funciona antes de alterar as credenciais. Se apenas Codex falhar, registre a versão Codex e execute a verificação CLI isolada.

Por que recebo um modelo não encontrado ou um 404 para GPT-5.6 Sol?

Confirme se o URL base termina em /v1 e inspecione GET /v1/models para obter o ID exato em letras minúsculas gpt-5.6-sol. Uma chave válida não garante acesso a todos os modelos.

Por que o GPT-5.6 não está disponível com meu login do ChatGPT Codex?

Codex autenticado por ChatGPT e uma chave API por meio de um provedor personalizado são caminhos de acesso separados. A disponibilidade em um não prova a disponibilidade no outro.

Devo tentar novamente um erro de resfriamento de todas as credenciais?

Siga o sinal de nova tentativa ou redefinição do provedor. Novas tentativas imediatas repetidas não corrigem um pool de credenciais esgotado e podem adicionar mais carga.

Quando devo executar o kit de compatibilidade?

Execute-o quando a mensagem por si só não identificar se o acesso ao modelo, Responses API ou Codex está falhando. Mantenha o relatório limpo quando precisar do suporte do provedor ou Codex.

Fontes verificadas

• Usando GPT-5.6
• Modelos GPT-5.6 em Codex
• Página do modelo GPT-5.6 Sol
• Página do modelo GPT-5.6 Terra
• Página do modelo GPT-5.6 Luna
• Referência de configuração Codex
• Autenticação Codex para provedores alternativos
• Guia de erro OpenAI API
• Codex problema #31870 e #31882, ambos abertos quando marcados