빠른 시작

API 키와 모델을 사용하여 첫 번째 애플리케이션을 게이트웨이에 연결합니다.

API 키 생성

콘솔에서 【API 키】 메뉴를 열고 충분한 할당량과 대상 모델 권한이 있는 키를 생성합니다. 예시의 YOUR_API_KEY를 해당 키로 교체하세요.

사용 가능한 모델

모델 목록은 키 및 그룹 접근 권한을 반영하며 모든 API와의 호환성을 의미하지는 않습니다. 모델 ID를 선택하기 전에 supported_endpoint_types 및 모델 문서를 확인하세요. 일부 모델은 Responses, 이미지 또는 특정 API만 지원할 수 있습니다.

curl 'https://routerra.ai/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

요청 보내기

채팅 완성 엔드포인트로 메시지를 전송합니다. YOUR_MODEL_ID를 키에서 사용 가능한 모델로 바꿉니다.

curl 'https://routerra.ai/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

문제 해결

인증 오류의 경우 키와 만료일을 확인하세요. 할당량 오류의 경우 잔액 및 키 한도를 확인하세요. 모델을 사용할 수 없는 경우 모델 ID 및 그룹 접근 권한을 확인하세요. 속도 제한의 경우 백오프를 적용하여 다시 시도하세요.