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 요청에 user 필드를 전달하여 사용자별 사용량 추적을 지원합니다. 이를 통해 애플리케이션의 개별 사용자에게 API 비용을 귀속시키고 사용자 수준에서 사용 패턴을 모니터링할 수 있습니다.
사용자 ID 전달하기
채팅 완성 요청에 user 필드를 포함합니다:
{
"model": "openai/gpt-5.4",
"messages": [{"role": "user", "content": "Hello!"}],
"user": "user_12345"
}
user 값은 시스템에서 최종 사용자를 식별하는 임의의 문자열이 될 수 있습니다 — 데이터베이스 ID, 해시된 이메일, 또는 세션 ID. ARouter는 이 값을 검증하거나 해석하지 않습니다.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.arouter.ai/v1",
apiKey: "lr_live_xxxx",
});
async function chatWithUser(userId: string, message: string) {
const response = await client.chat.completions.create({
model: "openai/gpt-5.4",
messages: [{ role: "user", content: message }],
user: userId,
});
return response.choices[0].message.content;
}
from openai import OpenAI
client = OpenAI(
base_url="https://api.arouter.ai/v1",
api_key="lr_live_xxxx",
)
def chat_with_user(user_id: str, message: str) -> str:
response = client.chat.completions.create(
model="openai/gpt-5.4",
messages=[{"role": "user", "content": message}],
user=user_id,
)
return response.choices[0].message.content
curl https://api.arouter.ai/v1/chat/completions \
-H "Authorization: Bearer lr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5.4",
"messages": [{"role": "user", "content": "Hello!"}],
"user": "user_12345"
}'
개인 정보 고려사항
user 값으로 개인 식별 정보(PII)를 전달하지 마세요. 해시된 ID나 데이터베이스 기본 키와 같은 불투명한 식별자를 사용하세요.
import hashlib
# 전달하기 전에 사용자 이메일 해시 처리
user_id = hashlib.sha256(user_email.encode()).hexdigest()[:16]
# 또는 불투명한 데이터베이스 ID 사용
user_id = str(user.id) # 예: "usr_abc123"
사용자별 사용량 보기
사용자 수준 사용량 데이터는 활동 내보내기에서 확인할 수 있습니다. 각 레코드에는 전달한 user 필드가 포함되어 다음이 가능합니다:
- 사용자별 Token 소비 및 비용 계산
- 용량 계획을 위한 고사용량 사용자 파악
- 비정상적인 사용 패턴이나 남용 감지
- 최종 사용자를 위한 사용량 기반 청구 구축
활동 내보내기 API
사용자별로 필터링하여 사용 기록 조회:
curl "https://api.arouter.ai/v1/activity?user=user_12345&limit=100" \
-H "Authorization: Bearer lr_live_xxxx"
사용 사례
사용자별 비용 배분
각 고객을 서비스하는 데 드는 비용 추적:
// 고객 ID 전달
const response = await client.chat.completions.create({
model: "anthropic/claude-sonnet-4.6",
messages: conversation,
user: `customer_${customerId}`,
});
// 나중에: 활동 내보내기를 조회하여 고객별 총 비용 확인
남용 감지
사용자별 비정상적인 사용 패턴 모니터링:
# 각 사용자에게 고유한 식별자 부여
response = client.chat.completions.create(
model="openai/gpt-5.4",
messages=[{"role": "user", "content": user_message}],
user=f"app_user_{user.id}",
)
멀티 테넌트 애플리케이션
멀티 테넌트 SaaS 애플리케이션에서 조직 또는 테넌트 ID 전달:
const response = await client.chat.completions.create({
model: "google/gemini-2.5-flash",
messages: messages,
user: `org_${organizationId}`,
});
참고 사항
user 필드는 선택 사항입니다. 이 필드가 없는 요청도 API 키의 집계 사용량으로 추적됩니다.- 사용자 ID는 불투명한 문자열로 저장됩니다. ARouter는 형식을 검증, 파싱 또는 해석하지 않습니다.
- 사용자 추적 데이터는 활동 내보내기 레코드에 포함됩니다.
- 팀 수준의 사용량 제어는 조직 관리를 참조하세요.
