Guia de integração de modelo de texto

Escolha primeiro um protocolo e depois copie a configuração completa para o seu cliente.

Você não precisa entender todas as APIs. Escolha Responses, Messages ou Chat — os protocolos que o AIReiter suporta atualmente — e depois copie uma configuração verificada com base na documentação oficial ou no código deste projeto.

Comparação de preçosOs modelos GPT-5.6 têm preço de 50% das taxas oficiais da API

Preço oficial da API vs preço da AIReiter

Todos os preços são por 1M tokens. A AIReiter está atualmente configurada para metade da taxa oficial do GPT-5.6, incluindo entrada normal, saída, entrada em cache e gravações em cache.

50%

O preço da AIReiter é metade do preço oficial da API em ambos os níveis de contexto e em todas as faixas de cobrança de cache.

ModeloNível de contextoEntradaSaídaLeitura de cacheGravação de cache
GPT-5.6 LunaContexto < 272K
Oficial$1.00AIReiter$0.50
Oficial$6.00AIReiter$3.00
Oficial$0.10AIReiter$0.05
Oficial$1.25AIReiter$0.625
GPT-5.6 LunaContexto >= 272K
Oficial$2.00AIReiter$1.00
Oficial$9.00AIReiter$4.50
Oficial$0.20AIReiter$0.10
Oficial$2.50AIReiter$1.25
GPT-5.6 TerraContexto < 272K
Oficial$2.50AIReiter$1.25
Oficial$15.00AIReiter$7.50
Oficial$0.25AIReiter$0.125
Oficial$3.125AIReiter$1.5625
GPT-5.6 TerraContexto >= 272K
Oficial$5.00AIReiter$2.50
Oficial$22.50AIReiter$11.25
Oficial$0.50AIReiter$0.25
Oficial$6.25AIReiter$3.125
GPT-5.6 SolContexto < 272K
Oficial$5.00AIReiter$2.50
Oficial$30.00AIReiter$15.00
Oficial$0.50AIReiter$0.25
Oficial$6.25AIReiter$3.125
GPT-5.6 SolContexto >= 272K
Oficial$10.00AIReiter$5.00
Oficial$45.00AIReiter$22.50
Oficial$1.00AIReiter$0.50
Oficial$12.50AIReiter$6.25

Como a cobrança corresponde à origem

O nível é escolhido pelo comprimento total do contexto de entrada. Os tokens em cache usam os preços de leitura de cache ou gravação de cache quando a origem informa cached_tokens ou cache_write_tokens; caso contrário, aplicam-se os preços normais de entrada e saída.

Protocolo Responses/api/v1/responses

Codex CLI

Ferramentas como o Codex CLI funcionam melhor com Responses. Os pontos principais: o base_url termina em /api/v1 e wire_api é definido como responses, com a chave lida da variável de ambiente indicada por env_key.

Oficial da OpenAIVer fonte

Os campos model_providers / base_url / wire_api / env_key vêm da documentação oficial de Advanced Configuration do Codex; que env_key deve apontar para uma variável de ambiente e que requires_openai_auth desativa env_key também são afirmações oficiais. Observe que wire_api só aceita responses desde o Codex 0.59.

URL base do cliente

https://aireiter.com/api/v1

Caminho anexado pelo cliente

/responses

URL final da requisição

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

Modelo de exemplo

gpt-5.6-luna

1

1. Escreva config.toml

Local do arquivo: ~/.codex/config.toml. base_url deve terminar em /api/v1; o Codex chama /responses conforme wire_api = "responses". env_key aponta para o nome de uma variável de ambiente — nunca coloque a chave real no TOML e não adicione requires_openai_auth = true: com isso o Codex ignora env_key e exige login oficial da OpenAI em vez disso.

Pronto para copiar
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. Exporte a variável de ambiente da chave API

O Codex lê a chave da variável de ambiente nomeada por env_key na inicialização. Escreva-a no perfil do seu shell para que ela persista; nunca faça commit da chave real em um repositório.

Pronto para copiar
echo 'export AIREITER_API_KEY="sk-substitua-pela-sua-chave"' >> ~/.zshrc
source ~/.zshrc
3

3. Configuração única para macOS / Linux

Ambas as etapas reunidas em um único bloco que você pode colar e executar. Se você já tiver um config.toml, faça a mesclagem manualmente para evitar sobrescrever outros provedores.

Pronto para copiar
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-substitua-pela-sua-chave"' >> ~/.zshrc
source ~/.zshrc
4

4. Configuração única para Windows PowerShell

Usuários do Windows copiem este bloco. setx grava uma variável de ambiente no nível do usuário; abra uma nova janela do terminal para que ela entre em vigor.

Pronto para copiar
$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-substitua-pela-sua-chave"
5

5. Verificação de conectividade

Solicite a lista de modelos primeiro. Inicie o Codex somente depois de receber uma lista JSON de volta — a solução de problemas fica muito mais fácil.

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

6. Inicie o Codex

Inicie após entrar no diretório do seu projeto. A saída em streaming significa que a integração com Responses funciona.

Pronto para copiar
cd ~/your-project
codex
7

Tabela de referência de códigos de status

Quando os usuários relatarem erros, verifique primeiro o código de status, depois o base_url e a chave.

Pronto para copiar
HTTP 200  A configuração está correta, inicie seu cliente
HTTP 401  A chave está incorreta ou ausente, copie novamente sua chave API
HTTP 403  A chave não tem acesso a este modelo, verifique a conta ou a permissão do modelo
HTTP 404  URL incorreta, primeiro verifique se o base_url tem /api/v1 a mais ou a menos
HTML retornado  A requisição atingiu o frontend do site, o base_url está incorreto
HTTP 502/504  Problema no gateway ou no upstream, tente novamente mais tarde
Referência rápida de clientes de terceirosTodos os campos de configuração vêm da documentação oficial de cada cliente

Qual endpoint para CC Switch ou OpenClaw?

Eles são clientes que carregam um protocolo, não protocolos em si: forneça às ferramentas no estilo Claude Code o endereço no estilo Anthropic, e às ferramentas compatíveis com OpenAI o /api/v1. Guias completos passo a passo estão abaixo no protocolo correspondente.

CC Switch

Na aba Claude Code, defina a base URL do provedor como https://aireiter.com/api — guia em "Messages protocol → CC Switch (GUI)". Na aba Codex, use https://aireiter.com/api/v1 — guia em "Responses protocol → CC Switch (GUI)".

OpenClaw

Com api: "openai-completions", defina baseUrl como https://aireiter.com/api/v1; com api: "anthropic-messages", use https://aireiter.com/api. Guia passo a passo em "Chat protocol → OpenClaw".

Alinhamento do setorComo gateways compatíveis com OpenAI escrevem baseURL

Não confunda a URL base com a URL final.

Gateways de modelos de texto como OpenRouter, Groq e Together têm o baseURL/base_url do SDK terminando em /v1, com o método do SDK acrescentando /chat/completions. Esta página os separa da mesma forma: URL base do cliente, caminho acrescentado pelo cliente e URL final da requisição são mostrados separadamente.

Existe um count_tokens?

Sim, em /api/v1/messages/count_tokens. Ele apenas faz contagem de tokens do Anthropic — não é um endpoint de geração.

As fontes são confiáveis?

As configurações prontas para copiar incluem apenas o que a documentação oficial, os protocolos OpenAI/Anthropic ou o código deste projeto conseguem verificar; clientes de terceiros recebem apenas notas de compatibilidade.

Qual os iniciantes devem escolher?

Codex → Responses; Claude Code → Messages; SDK da OpenAI e clientes genéricos compatíveis com OpenAI → Chat; se preferir não editar arquivos de configuração, use a interface gráfica CC Switch.