logo
텍스트 모델 통합 가이드

먼저 프로토콜을 선택한 다음, 클라이언트에 맞는 전체 설정을 복사하세요.

모든 API를 이해할 필요는 없습니다. AIReiter가 현재 지원하는 프로토콜인 Responses, Messages, Chat 중 하나를 선택한 뒤, 공식 문서나 이 프로젝트의 코드로 검증된 설정을 복사하세요.

설정 시작API 키 만들기개발자 문서
가격 비교GPT-5.6 모델은 공식 API 요금의 50%로 책정됩니다

공식 API 가격 vs AIReiter 가격

모든 가격은 100만 토큰당 기준입니다. AIReiter는 현재 일반 입력, 출력, 캐시된 입력, 캐시 쓰기를 포함해 공식 GPT-5.6 요금의 절반으로 설정되어 있습니다.

50%

AIReiter 가격은 두 컨텍스트 구간과 모든 캐시 과금 구간에서 공식 API 가격의 절반입니다.

모델컨텍스트 구간입력출력캐시 읽기캐시 쓰기
GPT-5.6 Luna컨텍스트 < 272K
공식$1.00AIReiter$0.50
공식$6.00AIReiter$3.00
공식$0.10AIReiter$0.05
공식$1.25AIReiter$0.625
GPT-5.6 Luna컨텍스트 >= 272K
공식$2.00AIReiter$1.00
공식$9.00AIReiter$4.50
공식$0.20AIReiter$0.10
공식$2.50AIReiter$1.25
GPT-5.6 Terra컨텍스트 < 272K
공식$2.50AIReiter$1.25
공식$15.00AIReiter$7.50
공식$0.25AIReiter$0.125
공식$3.125AIReiter$1.5625
GPT-5.6 Terra컨텍스트 >= 272K
공식$5.00AIReiter$2.50
공식$22.50AIReiter$11.25
공식$0.50AIReiter$0.25
공식$6.25AIReiter$3.125
GPT-5.6 Sol컨텍스트 < 272K
공식$5.00AIReiter$2.50
공식$30.00AIReiter$15.00
공식$0.50AIReiter$0.25
공식$6.25AIReiter$3.125
GPT-5.6 Sol컨텍스트 >= 272K
공식$10.00AIReiter$5.00
공식$45.00AIReiter$22.50
공식$1.00AIReiter$0.50
공식$12.50AIReiter$6.25

과금이 상위 시스템과 일치하는 방식

구간은 전체 입력 컨텍스트 길이에 따라 선택됩니다. 상위 시스템이 cached_tokens 또는 cache_write_tokens를 보고할 때는 캐시된 토큰에 캐시 읽기 또는 캐시 쓰기 요금이 적용되며, 그렇지 않으면 일반 입력 및 출력 가격이 적용됩니다.

Responses 프로토콜/api/v1/responses

Codex CLI

Codex CLI 같은 도구는 Responses를 통해 사용할 때 가장 잘 작동합니다. 핵심은 base_url이 /api/v1에서 끝나고 wire_api가 responses로 설정되며, 키는 env_key가 가리키는 환경 변수에서 읽는다는 점입니다.

OpenAI 공식소스 보기

model_providers / base_url / wire_api / env_key 필드는 Codex의 공식 Advanced Configuration 문서에서 가져왔습니다. env_key는 env 변수를 가리켜야 하며, requires_openai_auth는 env_key를 비활성화한다는 내용도 공식 설명입니다. Codex 0.59부터 wire_api는 responses만 허용합니다.

클라이언트 Base URL

https://aireiter.com/api/v1

클라이언트가 추가하는 경로

/responses

최종 요청 URL

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

예시 모델

gpt-5.6-luna

1

1. config.toml 작성

파일 위치: ~/.codex/config.toml. base_url은 반드시 /api/v1에서 끝나야 합니다. Codex는 wire_api = "responses"에 따라 /responses를 호출합니다. env_key는 환경 변수 이름을 가리키므로 TOML에 실제 키를 절대 넣지 마세요. 또한 requires_openai_auth = true를 추가하지 마세요: 이를 넣으면 Codex가 env_key를 무시하고 대신 공식 OpenAI 로그인을 요구합니다.

복사 가능
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. API 키 환경 변수 export

Codex는 시작할 때 env_key로 지정된 env var에서 키를 읽습니다. 영구적으로 유지되도록 셸 프로필에 기록하세요. 실제 키를 리포지토리에 절대 커밋하지 마세요.

복사 가능
echo 'export AIREITER_API_KEY="sk-replace-with-your-key"' >> ~/.zshrc
source ~/.zshrc
3

3. macOS / Linux 일회성 설정

두 단계를 하나의 블록으로 합쳐 두었으니, 붙여 넣고 실행하면 됩니다. 이미 config.toml이 있다면, 다른 provider를 덮어쓰지 않도록 수동으로 병합하세요.

복사 가능
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. Windows PowerShell 일회성 설정

Windows 사용자는 이 블록을 복사하세요. setx는 사용자 수준 env var를 작성하며, 적용되려면 새 터미널 창을 열어야 합니다.

복사 가능
$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. 연결 자체 점검

먼저 모델 목록을 요청하세요. JSON 목록을 받은 후에만 Codex를 실행하세요 — 문제 해결이 훨씬 쉬워집니다.

복사 가능
curl -sS -i "https://aireiter.com/api/v1/models" \
  -H "Authorization: Bearer $AIREITER_API_KEY" | head -n 20
6

6. Codex 실행

프로젝트 디렉터리에 들어간 뒤 실행하세요. 출력이 스트리밍되면 Responses 통합이 작동하는 것입니다.

복사 가능
cd ~/your-project
codex
7

상태 코드 치트 시트

사용자가 오류를 보고하면 먼저 상태 코드를 확인한 다음 base_url과 키를 확인하세요.

복사 가능
HTTP 200  설정이 올바릅니다. 클라이언트를 시작하세요
HTTP 401  키가 잘못되었거나 없습니다. API 키를 다시 복사하세요
HTTP 403  이 모델에 대한 키 접근 권한이 없습니다. 계정 또는 모델 권한을 확인하세요
HTTP 404  URL이 잘못되었습니다. 먼저 base_url에 /api/v1이 하나 더 있거나 빠져 있는지 확인하세요
HTML 반환됨  요청이 웹사이트 프런트엔드로 향했습니다. base_url이 잘못되었습니다
HTTP 502/504  게이트웨이 또는 상위 서버 일시 오류입니다. 나중에 다시 시도하세요
서드파티 클라이언트 빠른 참고모든 설정 필드는 각 클라이언트의 공식 문서에서 가져왔습니다

CC Switch 또는 OpenClaw에는 어느 엔드포인트를 사용하나요?

이들은 프로토콜을 담는 클라이언트일 뿐, 프로토콜 자체는 아닙니다. Claude Code 스타일 도구에는 Anthropic 스타일 주소를, OpenAI 호환 도구에는 /api/v1을 사용하세요. 전체 단계별 가이드는 위의 해당 프로토콜 아래에 있습니다.

CC Switch

Claude Code 탭에서는 provider base URL을 https://aireiter.com/api로 설정하세요 — 가이드는 "Messages protocol → CC Switch (GUI)" 아래에 있습니다. Codex 탭에서는 https://aireiter.com/api/v1을 사용하세요 — 가이드는 "Responses protocol → CC Switch (GUI)" 아래에 있습니다.

OpenClaw

api: "openai-completions"일 때 baseUrl을 https://aireiter.com/api/v1로 설정하세요. api: "anthropic-messages"일 때는 https://aireiter.com/api를 사용하세요. 단계별 가이드는 "Chat protocol → OpenClaw" 아래에 있습니다.

업계 정합성OpenAI 호환 게이트웨이가 baseURL을 쓰는 방식

base URL과 최종 URL을 혼동하지 마세요.

OpenRouter, Groq, Together 같은 텍스트 모델 게이트웨이는 모두 SDK baseURL/base_url을 /v1에서 끝내고, SDK 메서드가 /chat/completions를 덧붙입니다. 이 페이지도 같은 방식으로 나눠서 보여줍니다: 클라이언트 base URL, 클라이언트가 덧붙이는 경로, 최종 요청 URL을 각각 따로 표시합니다.

OpenRouter

OpenAI 호환 게이트웨이이며, SDK base URL은 /api/v1에서 끝납니다.

Groq

해당 OpenAI 호환 문서 역시 baseURL에 전체 엔드포인트를 넣지 말고 base URL만 바꾸라고 강조합니다.

Together AI

OpenAI-SDK 호환이기도 합니다. base URL + SDK 메서드 경로 조합은 동일합니다.

count_tokens가 있나요?

네, /api/v1/messages/count_tokens에 있습니다. 이는 Anthropic 토큰 계산만 수행하며, 생성 엔드포인트는 아닙니다.

출처는 신뢰할 수 있나요?

복사해 바로 사용할 수 있는 설정에는 공식 문서, OpenAI/Anthropic 프로토콜, 또는 이 프로젝트 코드로 확인 가능한 내용만 포함되어 있습니다. 서드파티 클라이언트에는 호환성 참고 사항만 제공합니다.

초보자는 무엇을 선택해야 하나요?

Codex → Responses; Claude Code → Messages; OpenAI SDK 및 일반 OpenAI 호환 클라이언트 → Chat; 설정 파일을 직접 수정하고 싶지 않다면 CC Switch GUI를 사용하세요.