Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
通过 API 请求中的 user 字段按用户追踪使用情况。适用于按用户分析、成本分摊和滥用检测。
user 字段来追踪每个用户的使用情况。这让您可以将 API 成本归因于应用程序中的具体用户，并在用户级别监控使用模式。
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 值传递。请使用不透明标识符，例如哈希 ID 或数据库主键。import hashlib
# 在传递之前对用户邮箱进行哈希处理
user_id = hashlib.sha256(user_email.encode()).hexdigest()[:16]
# 或使用不透明的数据库 ID
user_id = str(user.id) # 例如 "usr_abc123"
user 字段，让您能够：
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}",
)
const response = await client.chat.completions.create({
model: "google/gemini-2.5-flash",
messages: messages,
user: `org_${organizationId}`,
});