메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.arouter.ai/llms.txt

Use this file to discover all available pages before exploring further.

ARouter는 단일 API를 통해 개발자에게 수백 개의 모델에 대한 접근을 제공합니다. AI 모델이나 추론 제공업체를 운영하는 경우, ARouter와의 통합으로 이미 ARouter API를 기반으로 구축 중인 개발자들에게 직접 도달할 수 있습니다 — 코드 변경 없이.

ARouter와 파트너십의 장점

  • 즉각적인 개발자 도달 — ARouter를 사용하는 개발자들은 별도 계정 등록이나 SDK 없이 즉시 모델에 접근 가능
  • 제로 마찰 전환 — 개발자들은 문자열 하나만 변경해서 (model: "yourprovider/your-model") 모델을 시험할 수 있음
  • 트래픽 성장 — 모델이 ARouter 모델 카탈로그에 표시되고 통합된 /v1/models 엔드포인트를 통해 접근 가능
  • 투명한 가격 책정 — 가격은 귀하가 설정하며 ARouter가 최종 사용자에게 정확하게 반영

통합 요구사항

ARouter와 통합하려면 API가 다음을 제공해야 합니다:

1. OpenAI 호환 엔드포인트

ARouter는 OpenAI API 형식을 사용하여 요청을 라우팅합니다. 엔드포인트는 다음을 수락해야 합니다:
POST /v1/chat/completions
Server-Sent Events(SSE)를 통한 스트리밍을 포함한 표준 OpenAI 요청/응답 형식을 사용합니다.

2. 모델 ID

노출하는 각 모델에는 고유하고 안정적인 모델 ID가 있어야 합니다. ARouter는 provider/model 규칙을 사용합니다:
yourprovider/your-model-name

3. 사용량 보고

응답에는 정확한 토큰 수를 포함한 usage 객체가 포함되어야 합니다:
{
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "total_tokens": 150
  }
}

ARouter가 처리하는 내용

통합 후 ARouter는 다음을 사용자를 위해 투명하게 처리합니다:
책임ARouter귀하의 API
API Key 관리주입된 자격 증명으로 요청 라우팅자격 증명 검증
제공업체 상태 모니터링서킷 브레이커 + 키 풀 상태 확인요청에 응답
속도 제한키 및 사용자별 제한 추적귀하의 속도 제한 적용
사용량 기록토큰과 비용 기록응답에서 사용량 반환
스트리밍SSE 스트림 통과SSE 스트림 생성
오류 정규화오류 코드 표준화네이티브 오류 반환

모델 메타데이터

ARouter는 /v1/models 엔드포인트를 통해 개발자에게 풍부한 모델 메타데이터를 제공합니다. 각 모델에 다음을 제공할 수 있습니다:
{
  "id": "yourprovider/your-model",
  "name": "Your Model Name",
  "description": "A brief description of capabilities.",
  "context_length": 128000,
  "architecture": {
    "input_modalities": ["text", "image"],
    "output_modalities": ["text"],
    "tokenizer": "cl100k_base",
    "instruct_type": "chatml"
  },
  "pricing": {
    "prompt": "0.000002",
    "completion": "0.000006"
  },
  "supported_parameters": ["tools", "temperature", "max_tokens", "structured_outputs"]
}

지원되는 엔드포인트 유형

엔드포인트 유형설명
OpenAI Chat Completions스트리밍이 지원되는 표준 채팅
OpenAI Embeddings/v1/embeddings를 통한 텍스트 임베딩
Anthropic Messages네이티브 Anthropic 메시지 형식
Gemini GenerateContent네이티브 Gemini 형식
커스텀 엔드포인트제공업체 프록시를 통해 (/{yourprovider}/{path})

제공업체 프록시

개발자들은 또한 ARouter의 제공업체 프록시를 통해 API에 직접 요청을 보낼 수 있습니다. 모델 라우팅 레이어를 완전히 우회합니다:
POST /{yourprovider}/v1/chat/completions
이는 네이티브 API 형식을 사용하면서도 ARouter의 키 관리와 청구 혜택을 받고 싶은 개발자에게 유용합니다.

시작하기

모델을 ARouter에 통합하려면:
  1. API 문서와 모델 카탈로그를 providers@arouter.ai로 보내 연락하세요
  2. 자격 증명 제공 — ARouter가 사용할 API Key 또는 OAuth 자격 증명
  3. 모델 메타데이터 검토 — 모델 ID, 가격 책정, 컨텍스트 길이, 지원 매개변수 확인
  4. 통합 테스트 — ARouter 팀이 라우팅 및 응답 형식 호환성 검증
  5. 라이브 — 모델이 ARouter 카탈로그에 표시되어 즉시 접근 가능

데이터 처리

ARouter는 귀하의 데이터 정책을 존중합니다:
  • 요청/응답 데이터는 기본적으로 저장되지 않음데이터 수집 참조
  • 엔드포인트가 **제로 데이터 보존(ZDR)**을 지원하는지 지정 가능
  • 개발자는 요청별로 데이터 수집 옵트인/아웃 가능

가격 책정 및 수익

ARouter는 귀하의 가격 책정을 개발자에게 정확하게 반영합니다. 토큰당 가격은 귀하가 설정하며, ARouter는 표준 라우팅에 마크업을 추가하지 않습니다. 개발자는 ARouter를 통해 청구되고 귀하는 합의된 요율로 보상받습니다. 상업적 조건은 providers@arouter.ai로 문의하세요.