연동 키트API 연동OpenRouter
Hugging Face 오픈소스 LLM API 연동
- 누가 · 어디에
- 사내 서비스에 LLM을 도입하려는 백엔드 개발자가 AI 기능 개발 시
- 업무 효과
- OpenRouter 기반 자동 페일오버와 최저가 라우팅으로 가용성 확보 및 비용 절감
공식 API · SDK 로 우리 시스템에 붙입니다. AI 가 공식 문서를 찾아 정리한 가이드로, mopick 이 직접 따라 해 보지는 않았습니다 · 공식 문서에서 제품을 확인했습니다
준비할 것
- Hugging Face 계정
- Inference Providers 호출 권한이 부여된 Hugging Face 토큰
- OpenAI 규격 호환 클라이언트 또는 curl 실행 환경
연동 단계
해 본 단계는 번호를 눌러 표시하세요. 표시는 이 브라우저에만 남습니다.
0% 진행
API 토큰 발급
hf.co/settings/tokens에 접속해 'Make calls to Inference Providers' 권한을 체크한 새 User Access Token을 생성합니다.
모델 및 정책 지정
HF Hub에서 지원 모델 ID를 확인하고 속도 우선은 ':fastest', 비용 우선은 ':cheapest' 접미사를 모델 ID 뒤에 지정합니다.
엔드포인트 호출
기저 URL을 'https://router.huggingface.co/v1'로 지정하고 HF 토큰을 Bearer 인증 헤더에 넣어 chat/completions를 호출합니다.
붙여 넣는 설정 · 코드
YOUR_API_KEY 같은 자리에는 내 값을 넣으세요. 키는 코드 · 문서에 그대로 남기지 말고 환경 변수 · 비밀 저장소에 두세요.
OpenAI 호환 curl 요청 bash
curl https://router.huggingface.co/v1/chat/completions \
-H "Authorization: Bearer YOUR_HF_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "meta-llama/Llama-3.1-70B-Instruct:fastest",
"messages": [{"role": "user", "content": "안녕하세요"}]
}'- 잘 연결됐는지 확인
- curl 요청 후 HTTP 200 응답과 함께 JSON의 choices[0].message.content에 답변이 반환되는지 확인합니다.
- 비용
- 추가 마크업 없이 제공자 원가 기준으로 Hugging Face 계정에 청구됨
- 주의
- · 기존 개별 프로바이더 커스텀 API 키는 언어 모델 호출에 더 이상 지원되지 않으며 HF 계정으로 통합 청구됩니다.
- · OpenRouter 라우팅은 텍스트 언어 모델에만 적용되며 이미지·오디오·비디오 생성 모델은 HF 기존 경로를 유지합니다.
공식 문서
우리 회사 시스템에 붙여야 한다면 — 업무 앱 · 사내 자료 · 보안 조건에 맞춘 연동을 TPI INSIGHT AX센터가 함께합니다.