Skip to main content
업데이트: 2026-06-06

연동 튜토리얼

이 문서 페이지에는 2026-03-23에 Crazyrouter 프로덕션 환경에서 재검증된 시작 경로만 작성되어 있습니다. 가장 빠르게 시작하려면 먼저 세 가지 연동 방식을 구분하세요.
  • OpenAI 호환: https://api.crazyrouter.com/v1
  • Anthropic 네이티브: https://api.crazyrouter.com
  • Gemini 네이티브: https://api.crazyrouter.com/v1beta/models/...

최소 마이그레이션 원칙

OpenAI 호환 클라이언트에서 Crazyrouter로 마이그레이션할 때는 보통 두 가지만 변경하면 됩니다.
  1. base_url을 https://api.crazyrouter.com/v1로 변경
  2. api_key를 Crazyrouter의 sk-xxx로 변경

OpenAI에서 마이그레이션

이번 프로덕션 재검증에서 확인된 사항:
  • gpt-5.5는 /v1/chat/completions를 통해 정상적으로 응답함
  • reasoning 요약이나 OpenAI 스타일 web search가 필요하다면 /v1/responses로 전환하는 것을 우선하세요
관련 페이지:

Anthropic에서 마이그레이션

방안 A: OpenAI 호환 레이어 계속 사용

방안 B: Anthropic 네이티브 Messages 사용

다음과 같은 목표가 있다면:
  • 일반적인 Claude 대화: claude-opus-4-8을 우선 사용
  • thinking block이 명확히 필요한 경우: claude-opus-4-8을 우선 사용
관련 페이지:

Gemini에서 마이그레이션

방안 A: OpenAI 호환 레이어

방안 B: Gemini 네이티브

다음과 같은 목표가 있다면:
  • 기존 OpenAI SDK 코드만 재사용: 먼저 호환 레이어 사용
  • 구조화된 출력, Google Search, thinking이 필요: Gemini 네이티브를 우선 사용
관련 페이지:

환경 변수 방식

OpenAI 호환 레이어를 사용한다면, 먼저 다음을 설정하는 것을 권장합니다.
그런 다음 코드에서 바로 다음과 같이 사용할 수 있습니다.

시작 권장 사항

Crazyrouter는 OpenAI, Anthropic, Gemini 세 가지 프로토콜을 모두 지원합니다. 더 안정적인 방법은 보통 “모든 모델을 강제로 동일한 프로토콜로 처리”하는 것이 아니라, 능력에 따라 가장 적합한 진입점을 선택하는 것입니다.