개발 문서
개요
OpenAI 호환 엔드포인트 하나로 10개 Provider의 모델을 호출합니다. 기존 SDK에서 base_url과 키만 바꾸면 첫 호출이 나갑니다.
빠른 시작
콘솔에서 서비스 API 키를 만들고 아래 세 줄을 바꿉니다. model에 route를 넣으면 요청마다 후보를 다시 고르고, 모델 ID를 직접 넣으면 그 모델로 고정됩니다.
curl https://api.alpharouter.ai/v1/chat/completions \ -H "Authorization: Bearer $ALPHAROUTER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "alpharouter/route", "messages": [{"role":"user","content":"분기 보고서를 요약해줘"}] }'지원 endpoint
같은 키로 아래 경로를 모두 씁니다. 경로마다 호환 가능한 모델만 후보에 오릅니다.
| Endpoint | Method | Type |
|---|---|---|
| /chat/completions | POST | Chat, streaming, tools, vision |
| /responses | POST | Server-stored conversations, SSE |
| /messages | POST | Anthropic-native shape |
| /embeddings | POST | Embedding, reranking |
| /images/generations | POST | Image generation, editing |
| /audio/speech | POST | Text to speech |
| /audio/transcriptions | POST | Speech to text |
| /models | GET | Catalog, pricing, specs |
다음 단계
- 인증 문서에서 키 종류와 헤더 규칙을 확인하세요.
- 스마트 라우팅 문서에서 route 경로와 전략을 설정하세요.
- 에러 처리 문서에서 재시도와 멱등성 규칙을 확인하세요.