Guía de integración del modelo de texto

Primero elige un protocolo y luego copia la configuración completa para tu cliente.

No necesitas entender todas las API. Elige Responses, Messages o Chat — los protocolos que AIReiter admite actualmente — y luego copia una configuración verificada con la documentación oficial o el código de este proyecto.

Comparación de preciosLos modelos GPT-5.6 tienen un precio del 50% de las tarifas oficiales de la API

Precio oficial de la API vs precio de AIReiter

Todos los precios son por 1M de tokens. AIReiter actualmente está configurado al 50% de la tarifa oficial de GPT-5.6, incluyendo entrada normal, salida, entrada en caché y escrituras en caché.

50%

El precio de AIReiter es la mitad del precio oficial de la API en ambos niveles de contexto y en todos los tramos de facturación de caché.

ModeloNivel de contextoEntradaSalidaLectura de cachéEscritura de caché
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

Cómo la facturación coincide con el upstream

El nivel se elige según la longitud total del contexto de entrada. Los tokens en caché usan los precios de lectura o escritura de caché cuando el upstream informa cached_tokens o cache_write_tokens; de lo contrario, se aplican los precios normales de entrada y salida.

Protocolo Responses/api/v1/responses

Codex CLI

Herramientas como Codex CLI funcionan mejor con Responses. Los puntos clave: base_url termina en /api/v1 y wire_api se establece en responses, con la clave leída desde la variable de entorno indicada por env_key.

OpenAI oficialVer código fuente

Los campos model_providers / base_url / wire_api / env_key provienen de la documentación oficial de Advanced Configuration de Codex; que env_key deba apuntar a una variable de entorno y que requires_openai_auth desactive env_key son también declaraciones oficiales. Ten en cuenta que wire_api solo acepta responses desde Codex 0.59.

URL base del cliente

https://aireiter.com/api/v1

Ruta añadida por el cliente

/responses

URL final de la solicitud

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

Modelo de ejemplo

gpt-5.6-luna

1

1. Escribe config.toml

Ubicación del archivo: ~/.codex/config.toml. base_url debe terminar en /api/v1; Codex llama a /responses según wire_api = "responses". env_key apunta a un nombre de variable de entorno — nunca pongas la clave real en el TOML, y no añadas requires_openai_auth = true: con eso Codex ignora env_key y exige iniciar sesión oficial de OpenAI en su lugar.

Listo 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. Exporta la variable de entorno de la clave API

Codex lee la clave de la variable de entorno nombrada por env_key al iniciarse. Escríbela en tu perfil de shell para que persista; nunca confirmes la clave real en un repositorio.

Listo para copiar
echo 'export AIREITER_API_KEY="sk-replace-with-your-key"' >> ~/.zshrc
source ~/.zshrc
3

3. Configuración de un solo paso para macOS / Linux

Ambos pasos fusionados en un solo bloque que puedes pegar y ejecutar. Si ya tienes un config.toml, fusiona manualmente para evitar sobrescribir otros proveedores.

Listo 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-replace-with-your-key"' >> ~/.zshrc
source ~/.zshrc
4

4. Configuración de un solo paso para Windows PowerShell

Los usuarios de Windows copian este bloque. setx escribe una variable de entorno a nivel de usuario; abre una nueva ventana de terminal para que surta efecto.

Listo 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-replace-with-your-key"
5

5. Comprobación de conectividad

Solicita primero la lista de modelos. Inicia Codex solo después de recibir de vuelta una lista JSON — la depuración se vuelve mucho más fácil.

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

6. Iniciar Codex

Inícialo después de entrar en el directorio de tu proyecto. La salida en streaming significa que la integración de Responses funciona.

Listo para copiar
cd ~/your-project
codex
7

Chuleta de códigos de estado

Cuando los usuarios informen errores, revisa primero el código de estado, luego base_url y la clave.

Listo para copiar
HTTP 200  La configuración es correcta, inicia tu cliente
HTTP 401  La clave es incorrecta o falta, vuelve a copiar tu clave API
HTTP 403  La clave no tiene acceso a este modelo, revisa la cuenta o los permisos del modelo
HTTP 404  URL incorrecta, primero verifica si base_url tiene un /api/v1 adicional o faltante
HTML devuelto  La solicitud llegó al frontend del sitio web, base_url es incorrecta
HTTP 502/504  Problema de gateway o upstream, inténtalo de nuevo más tarde
Referencia rápida de clientes de tercerosTodos los campos de configuración provienen de la documentación oficial de cada cliente

¿Qué endpoint usar para CC Switch o OpenClaw?

Son clientes que transportan un protocolo, no protocolos en sí mismos: da a las herramientas estilo Claude Code la dirección estilo Anthropic, y a las herramientas compatibles con OpenAI /api/v1. Las guías completas paso a paso están en el protocolo correspondiente arriba.

CC Switch

En la pestaña Claude Code, establece la base URL del proveedor en https://aireiter.com/api — guía en "Messages protocol → CC Switch (GUI)". En la pestaña Codex usa https://aireiter.com/api/v1 — guía en "Responses protocol → CC Switch (GUI)".

OpenClaw

Con api: "openai-completions" establece baseUrl en https://aireiter.com/api/v1; con api: "anthropic-messages" usa https://aireiter.com/api. Guía paso a paso en "Chat protocol → OpenClaw".

Alineación del sectorCómo escriben baseURL los gateways compatibles con OpenAI

No confundas la base URL con la URL final.

Los gateways de modelos de texto como OpenRouter, Groq y Together tienen todos el baseURL/base_url del SDK terminando en /v1, y el método del SDK añade /chat/completions. Esta página los separa de la misma manera: se muestran por separado la base URL del cliente, la ruta añadida por el cliente y la URL final de la solicitud.

¿Existe count_tokens?

Sí, en /api/v1/messages/count_tokens. Solo realiza conteo de tokens de Anthropic — no es un endpoint de generación.

¿Son fiables las fuentes?

Las configuraciones listas para copiar solo incluyen lo que la documentación oficial, los protocolos de OpenAI/Anthropic o el código de este proyecto pueden verificar; los clientes de terceros reciben solo notas de compatibilidad.

¿Cuál deberían elegir los principiantes?

Codex → Responses; Claude Code → Messages; SDK de OpenAI y clientes genéricos compatibles con OpenAI → Chat; si prefieres no editar archivos de configuración, usa la interfaz CC Switch GUI.