저는 최근 6개월간 사내 AI 워크플로우 자동화 프로젝트를 진행하면서 Kimi, Qwen, GLM, Baichuan 네 가지 중국 출시 대규모 언어 모델을 동시에 운영해야 하는 상황에 직면했습니다. 각각의 공식 API 엔드포인트, 인증 방식, 응답 포맷이 미세하게 달라서 어댑터 레이어를 직접 설계했고, 그 경험을 바탕으로 이 마이그레이션 플레이북을 정리합니다. 본격적인 통합 절차에 앞서 지금 가입을 진행해 두시면 후반부의 모든 코드 예제를 그대로 실행해 볼 수 있습니다.

왜 어댑터 레이어가 필요한가

저는 처음에 각 벤더의 공식 SDK를 그대로 사용했는데, 세 가지 문제가 즉시 드러났습니다.