메인 콘텐츠로 건너뛰기

​
시작하기

ARouter는 통합 API 게이트웨이입니다. OpenAI, Anthropic, Google, DeepSeek, xAI 등 세계 최고의 AI 모델에 단일 OpenAI 호환 API로 접근할 수 있습니다.API key 하나, 결제 계정 하나, 통합 하나만 관리하면 됩니다. ARouter가 라우팅, 인증, 장애 조치, 사용량 추적을 투명하게 처리합니다.
  1. https://api.arouter.ai에서 계정 생성
  2. 대시보드에서 API key 생성
  3. OpenAI 호환 클라이언트의 base URL을 https://api.arouter.ai/v1로 설정
  4. 첫 번째 요청 전송
단계별 가이드는 빠른 시작을 참조하세요.
  • GitHub Issues: github.com/arouter-ai
  • 이메일: 대시보드에서 연락처 정보 확인
  • 문서: 지금 보고 계십니다!

​
결제

ARouter는 크레딧 기반 시스템을 사용합니다. 크레딧을 미리 구매하면 요청당 token 사용량에 따라 소비됩니다.잔액과 거래 내역은 대시보드 또는 API에서 확인할 수 있습니다.
ARouter는 상위 제공업체가 공개한 추론 요금을 그대로 적용합니다. 크레딧 구매 시 플랫폼 수수료가 부과됩니다.Token 수는 상위 제공업체가 보고한 값과 정확히 일치하며 각 응답의 usage 필드에 반영됩니다.
결제 약관에 따라 미사용 크레딧은 구매 후 1년 후에 만료될 수 있습니다.
미사용 크레딧의 환불 요청은 구매 후 24시간 이내에 해야 합니다. 그 이후에는 미사용 크레딧이 환불되지 않습니다.플랫폼 수수료는 환불되지 않으며, 암호화폐 결제도 환불되지 않습니다.
예. 먼저 월간 무료 허용량이 있으며, 그 이상 사용하면 소액의 ARouter 플랫폼 수수료가 발생하고 추론 비용은 본인 제공업체 key로 청구됩니다.
API 경유:
curl https://api.arouter.ai/api/v1/balance \
  -H "Authorization: Bearer lr_live_xxxx"
또는 대시보드 https://arouter.ai/billing에서 확인할 수 있습니다.
구매를 완료했는데 잔액이 즉시 업데이트되지 않는다면, 결제 정산이 완료될 때까지 잠시 기다려 주세요.청구가 성공했는데도 크레딧이 반영되지 않는다면, 구매 세부 정보를 첨부하여 대시보드를 통해 지원팀에 문의하시면 결제를 추적해 드립니다.
ARouter는 대시보드에서 카드 기반 크레딧 구매와 x402 등 지원되는 결제 방식을 통한 암호화폐 충전을 지원합니다.
계정에 무료 크레딧이나 프로모션 사용량이 포함된 경우, 해당 요청은 프로덕션 용도보다는 테스트 용도로 사용하는 것이 좋습니다. 계정 수준 및 플랜 수준의 제한은 여전히 적용됩니다.

​
모델

ARouter는 OpenAI, Anthropic, Google, DeepSeek, xAI, Mistral, Meta, Qwen, MiniMax, Groq, Kimi, Cohere, NVIDIA, Dashscope의 모델을 지원합니다.GET /v1/models를 사용하여 계정에서 이용 가능한 전체 목록을 확인하세요:
curl https://api.arouter.ai/v1/models \
  -H "Authorization: Bearer lr_live_xxxx"
자세한 내용은 모델과 제공업체를 참조하세요.
model 필드에 provider/model 형식을 사용하세요:
  • openai/gpt-5.4
  • anthropic/claude-sonnet-4.6
  • google/gemini-2.5-flash
  • deepseek/deepseek-v3.2
전체 참조는 모델 라우팅을 참조하세요.
예. model을 "auto"로 설정하면 ARouter의 라우팅 서비스가 요청에 가장 적합한 모델을 선택합니다:
{
  "model": "auto",
  "messages": [{ "role": "user", "content": "Hello!" }]
}
응답에는 항상 실제 사용된 모델을 나타내는 model 필드가 포함됩니다. 자세한 내용은 모델 라우팅 — 자동 라우팅을 참조하세요.
예. models 배열을 route와 함께 사용하세요:
{
  "models": ["anthropic/claude-opus-4.5", "openai/gpt-5.4"],
  "route": "fallback",
  "messages": [...]
}
ARouter는 순서대로 모델을 평가하고 첫 번째 성공 결과를 반환합니다. 자세한 내용은 모델 라우팅을 참조하세요.

​
API 기술

ARouter는 세 가지 인증 방법을 지원합니다:
  • Bearer token: Authorization: Bearer lr_live_xxxx (OpenAI SDK, fetch)
  • API Key header: X-Api-Key: lr_live_xxxx (Anthropic SDK)
  • 쿼리 파라미터: ?key=lr_live_xxxx (Gemini SDK)
각 SDK의 자세한 설정은 인증 가이드를 참조하세요.
속도 제한은 API key별로 적용되며 대시보드에서 설정할 수 있습니다. 기본 제한은 플랜에 따라 다릅니다.모든 응답에 속도 제한 헤더가 포함됩니다:
  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset
자세한 내용은 API 참조를 참조하세요.
ARouter가 제공하는 엔드포인트:
  • /v1/chat/completions — OpenAI 호환 채팅
  • /v1/embeddings — OpenAI 호환 embeddings
  • /v1/models — 이용 가능한 모델 목록
  • /v1/messages — Anthropic 네이티브
  • /v1beta/models/{model}:generateContent — Gemini 네이티브
  • /api/v1/balance — 계정 잔액
  • /api/v1/transactions — 거래 내역
  • /api/v1/keys — API key 관리
  • /{provider}/{path} — 제공업체 프록시
전체 목록은 API 참조를 참조하세요.
ARouter가 지원하는 형식:
  • 텍스트: 모든 모델
  • 이미지: 비전 지원 모델 (URL 또는 base64)
  • PDF: Anthropic Claude와 Google Gemini
자세한 내용은 멀티모달을 참조하세요.
예. 요청에 stream: true를 설정하세요. ARouter는 모든 제공업체에 대해 Server-Sent Events (SSE) 스트리밍을 지원합니다.SSE 형식, 오류 처리, 취소를 포함한 전체 가이드는 스트리밍을 참조하세요.
ARouter는 다음 SDK와 호환됩니다:
  • Python: OpenAI SDK (pip install openai)
  • Node.js / TypeScript: OpenAI SDK (npm install openai)
  • Go: ARouter Go SDK (go get github.com/arouter-ai/arouter-go)
  • Anthropic SDK: Python과 Node.js
  • Google Gemini SDK: Python
  • 모든 HTTP 클라이언트: cURL, fetch 등
설정 가이드는 SDK 섹션을 참조하세요.

​
개인정보 및 데이터

ARouter는 기본적으로 프롬프트 내용을 저장하지 않습니다. 요청 본문은 상위 제공업체로 전달되며 ARouter에 보관되지 않습니다.사용량 메타데이터(token 수, 모델, 타임스탬프, 비용)는 결제 및 분석 목적으로 저장됩니다.전체 정책은 데이터 수집을 참조하세요.
귀하의 특정 요청을 처리하는 상위 제공업체만 프롬프트 내용을 볼 수 있습니다. model 필드로 선택한 제공업체가 요청을 처리합니다. ARouter는 투명한 프록시 역할을 합니다.상위 제공업체 데이터 정책에 대한 자세한 내용은 제공업체 로깅을 참조하세요.
provider.data_collection: "deny"를 사용하여 모델 학습에 요청 데이터를 사용하지 않는 제공업체로만 라우팅을 제한하세요:
{
  "model": "anthropic/claude-sonnet-4.6",
  "provider": {"data_collection": "deny"}
}
또는 제로 데이터 리텐션 적용을 위해 provider.zdr: true를 사용하세요. 제공업체 라우팅 — 데이터 수집 정책을 참조하세요.
예. 요청에 provider.zdr: true를 설정하면 제로 데이터 리텐션 계약을 맺은 제공업체로만 라우팅이 제한됩니다. 제공업체 라우팅을 참조하세요.

​
모델과 제공업체

모델 ID에 접미사를 추가하여 라우팅 동작을 변경할 수 있습니다:
  • :nitro — 처리량이 가장 높은 인스턴스로 라우팅
  • :floor — 비용이 가장 낮은 인스턴스로 라우팅
  • :free — 무료 플랜 인스턴스 사용 (속도 제한 적용)
  • :thinking — 확장된 Chain-of-Thought 추론 활성화
  • :extended — 더 큰 컨텍스트 윈도우 버전 사용
{"model": "openai/gpt-5.4:nitro"}
전체 참조는 모델 변형을 참조하세요.
예. content 배열에 텍스트와 함께 이미지 URL 또는 base64 인코딩된 이미지를 전달하세요. PDF는 Anthropic Claude와 Google Gemini에서 지원됩니다.
{
  "model": "openai/gpt-5.4",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "이 이미지에 무엇이 있나요?"},
      {"type": "image_url", "image_url": {"url": "https://..."}}
    ]
  }]
}
예시는 멀티모달을 참조하세요.
예. ARouter는 OpenAI 도구 호출 표준을 사용하여 모든 주요 제공업체에서 도구/함수 호출을 지원합니다. 요청에 tools와 tool_choice를 전달하세요.전체 가이드는 도구 호출을 참조하세요.
예. 유효한 JSON 출력에는 response_format: {"type": "json_object"}를, 스키마 강제 출력에는 response_format: {"type": "json_schema", "json_schema": {...}}를 사용하세요.자세한 내용은 구조화된 출력을 참조하세요.
예. OpenAI, DeepSeek, xAI, Groq 모델은 프롬프트 캐싱을 자동으로 지원합니다. Anthropic의 경우 명시적 캐싱에 cache_control 블록을 사용하세요. Google Gemini는 자동 및 명시적 캐싱을 모두 지원합니다.전체 가이드는 프롬프트 캐싱을 참조하세요.

​
계정 관리

예. API key 생성 또는 업데이트 시 spending_limit을 설정하여 해당 key의 지출 상한을 설정할 수 있습니다:
curl -X POST https://api.arouter.ai/v1/keys \
  -H "Authorization: Bearer lr_live_xxxx" \
  -d '{"name": "production", "spending_limit": 100.00}'
자세한 내용은 Key 관리를 참조하세요.
key 생성 시 allowed_providers를 설정하세요:
{
  "name": "openai-only-key",
  "allowed_providers": ["openai", "anthropic"]
}
자세한 내용은 Key 관리를 참조하세요.
예. 다양한 환경, 서비스, 사용 사례에 대해 여러 API key를 만들 수 있습니다. 각 key는 독립적인 지출 한도, 제공업체 제한, 사용량 추적을 가집니다.대시보드 또는 Key 관리 API에서 key를 관리하세요.
예. 각 요청에 최종 사용자의 불투명한 식별자가 포함된 user 필드를 전달하세요. 이후 활동 내보내기에서 사용자별 사용량을 확인할 수 있습니다.
{"model": "openai/gpt-5.4", "user": "user_12345", "messages": [...]}
자세한 내용은 사용자 추적을 참조하세요.
예. 조직 관리를 사용하여 공유 조직을 만들고, 팀원을 초대하고, 공유 크레딧을 관리하고, 권한을 제어하세요.