Skip to content
PleumRouter

App Attribution

공개 앱별 토큰 랭킹에 기여하는 선택적 식별 헤더. OpenRouter와 호환됩니다.

왜 출처를 표시하나요?#

앱을 만들어 PleumRouter를 통해 호출한다면, 두 개의 식별 헤더로 호출의 출처를 표시할 수 있습니다. 이 헤더들은 공개 앱별 토큰 리더보드를 채워 여러분의 앱을 노출시킵니다. 헤더 이름은 OpenRouter와 동일하므로, 기존 OpenRouter 설정이 그대로 적용됩니다.

헤더 보내기#

과금되는 모든 호출(예: POST /v1/chat/completions)에 HTTP-Referer(앱 URL)와 X-Title(앱 이름)를 함께 보낼 수 있습니다. 둘 다 선택 사항입니다.

chat completion with attribution headers
curl https://router.pleum.ai/v1/chat/completions \
  -H "Authorization: Bearer $PLEUM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://myapp.example.com" \
  -H "X-Title: My App" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
두 헤더 모두 자가 신고 값으로 검증되지 않으며, 각각 200자로 잘립니다. 값은 사용량 로그에 저장됩니다.

리더보드#

GET/v1/stats/apps

GET /v1/stats/apps는 공개 엔드포인트로 인증이 필요 없습니다. 상위 20개 앱을 토큰 사용량 순으로 반환합니다.

파라미터타입필수설명
periodstring선택daily | weekly | monthly. 기본값 weekly.
200 OK
{
  "leaderboard": [
    {
      "rank": 1,
      "app": "My App",
      "site": "https://myapp.example.com",
      "tokens": 523000,
      "calls": 410,
      "trend_pct": 12.4
    }
  ]
}

앱 키는 X-Title이 있으면 그 값을, 없으면 referer의 호스트(경로 제거)를 사용합니다. trend_pct는 직전 기간 대비 변화율이며, 이전 데이터가 없으면 null입니다.

값은 자가 신고이므로 검증되지 않습니다. 두 헤더가 모두 없는 호출이나 상태 코드가 400 이상인 호출은 리더보드 집계에서 제외됩니다.