앱과 코딩 에이전트 연결

Route Key API 키 하나와 호환 게이트웨이로 앱, SDK, 코딩 도구를 연결하세요.

Create API key 모델 탐색
단계 01

AI 애플리케이션 연결

세 가지 값으로 첫 호환 요청을 보낼 수 있습니다.

  • Base URLhttps://api.routekey.ai/v1
  • AuthorizationBearer YOUR_ROUTEKEY_API_KEY
  • 모델Models에서 활성 ID를 선택하세요.
첫 작동 요청
curl https://api.routekey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_ROUTEKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<route-key-model>","messages":[{"role":"user","content":"Hello"}]}'
단계 02

코딩 에이전트 설정

도구마다 전용 키를 사용하고 맞는 설정 프로필을 복사하세요.

Install Codex공식 문서
npm install -g @openai/codex
~/.codex/config.toml
model = "<route-key-coding-model>"
model_provider = "routekey"

[model_providers.routekey]
name = "Route Key"
base_url = "https://api.routekey.ai/v1"
env_key = "ROUTEKEY_API_KEY"
  • 전용 Route Key API 키를 만드세요.
  • Models에서 활성 모델을 선택하세요.
  • 도구를 재시작하고 사용 로그를 확인하세요.
운영 체크리스트

모든 통합을 유지보수 가능하게

OpenAI 호환성은 이전 작업을 줄이지만 도구별 키, 검증된 모델, 설정 가능한 base URL과 관찰 가능성이 필요합니다. 모델.

개발자 문서 읽기 지원 모델 비교
안전하고 재현 가능한 API 연결 준비

API 키 생성 및 보호

Dashboard에서 키를 만들고 앱이나 도구마다 전용 키를 사용하세요. 환경 변수나 시크릿 저장소에 보관하고 코드와 로그에 노출하지 마세요.

요청의 세 가지 값 이해

base URL은 게이트웨이, Bearer 토큰은 인증, 모델 ID는 활성 모델을 선택합니다. Models 페이지의 정확한 ID를 사용하세요. 모델.

전체 배포 전 접근 확인

잔액 또는 쿼터, 모델 그룹, endpoint 지원 여부를 확인하세요. 짧은 비스트리밍 요청이 문제를 가장 빠르게 분리합니다.

첫 응답과 사용 로그 확인
  1. 짧은 요청을 보내고 일반 응답 또는 스트림을 확인합니다.
  2. 응답한 모델 ID와 endpoint를 기록해 설정을 재현합니다.
  3. 사용 로그에서 요청, 토큰, 지연 시간, 비용을 확인합니다.
  4. 스트리밍, 도구, 긴 컨텍스트, 동시 실행을 하나씩 추가합니다.

401 또는 403 인증 오류

Authorization: Bearer 접두사, 공백, 키 상태, /v1 base URL을 확인하세요.

모델을 찾을 수 없거나 사용할 수 없음

Models에서 활성 모델 ID를 복사하고 그룹과 endpoint를 확인하세요.

쿼터, 잔액 또는 속도 오류

지갑, 계정 제한, 사용 로그를 확인하고 테스트의 동시 실행이나 출력을 줄이세요.

기존 OpenAI SDK를 사용할 수 있나요?

대부분 가능합니다. SDK 형식을 유지하고 base URL을 Route Key /v1로 설정한 뒤 Route Key API 키를 전달하세요.

여러 도구가 하나의 키를 공유해야 하나요?

아니요. 앱이나 에이전트별 키가 로그 확인과 교체를 안전하게 만듭니다.

비용 차이는 어디서 조사하나요?

사용 로그에서 모델, 그룹 비율, 입출력 토큰, endpoint, 시간을 비교한 뒤 가격 카탈로그를 확인하세요.