ARouter의 제공업체 프록시를 사용하면 ARouter API Key를 인증으로 사용하여 지원되는 제공업체의 네이티브 API에 직접 요청을 전달할 수 있습니다. 각 제공업체에 대한 개별 API Key를 관리할 필요가 없습니다.
엔드포인트
POST /{provider}/{path}
GET /{provider}/{path}
{provider}는 제공업체 슬러그이고, {path}는 제공업체의 네이티브 API 경로입니다.
제공업체 프록시 사용 시기
| 사용 사례 | 권장 방법 |
|---|
| 표준 LLM 채팅 완성 | provider/model 형식의 /v1/chat/completions |
| 제공업체별 기능 (예: Anthropic Batches, Gemini 캐시 콘텐츠) | /{provider}/{path} 프록시 |
| 네이티브 스트리밍 형식 | /{provider}/{path} 프록시 |
| ARouter 스키마에 없는 제공업체별 파라미터 | /{provider}/{path} 프록시 |
지원되는 제공업체
| 제공업체 | 슬러그 | 기본 URL |
|---|
| OpenAI | openai | https://api.openai.com |
| Anthropic | anthropic | https://api.anthropic.com |
| Google Gemini | google | https://generativelanguage.googleapis.com |
| DeepSeek | deepseek | https://api.deepseek.com |
| xAI | xai | https://api.x.ai |
| Kimi (Moonshot) | kimi | https://api.moonshot.cn |
| MiniMax | minimax | https://api.minimax.chat |
| Mistral | mistral | https://api.mistral.ai |
| Groq | groq | https://api.groq.com |
| Cohere | cohere | https://api.cohere.com |
| NVIDIA | nvidia | https://integrate.api.nvidia.com |
| Dashscope (알리바바) | dashscope | https://dashscope.aliyuncs.com |
OpenAI — 채팅 완성
curl https://api.arouter.ai/openai/v1/chat/completions \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "Hello!"}]
}'
Anthropic — 메시지
curl https://api.arouter.ai/anthropic/v1/messages \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4.6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
Anthropic — 메시지 배치
# 배치 생성
curl https://api.arouter.ai/anthropic/v1/messages/batches \
-X POST \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{
"custom_id": "request-1",
"params": {
"model": "claude-sonnet-4.6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}
}
]
}'
# 배치 상태 확인
curl https://api.arouter.ai/anthropic/v1/messages/batches/msgbatch_xxx \
-H "Authorization: Bearer lr_live_xxxx"
Google Gemini — 콘텐츠 생성
curl "https://api.arouter.ai/google/v1beta/models/gemini-2.5-flash:generateContent" \
-X POST \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{"role": "user", "parts": [{"text": "Hello!"}]}
]
}'
Google Gemini — 모델 목록
curl "https://api.arouter.ai/google/v1beta/models" \
-H "Authorization: Bearer lr_live_xxxx"
DeepSeek — 채팅 완성
curl https://api.arouter.ai/deepseek/v1/chat/completions \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v3.2",
"messages": [{"role": "user", "content": "Hello!"}]
}'
참고 사항
- 인증: ARouter가 제공업체의 API Key를 자동으로 주입합니다. ARouter Key만 필요합니다.
- 네이티브 형식: 요청과 응답은 그대로 전달됩니다 — ARouter는 변환을 수행하지 않습니다.
- 사용량 추적: Token 사용량은 여전히 ARouter 계정에 기록됩니다.
- 경로 패스스루:
/{provider}/ 이후의 모든 내용이 제공업체에 그대로 전달됩니다.
Anthropic에 제공업체 프록시를 사용할 때 anthropic-version 헤더가 자동으로 주입됩니다. 포함할 필요가 없습니다.