接口
认证
使用会话 Cookie 认证，或携带Authorization: Bearer <api-key>。
查询参数
string
时间范围起点，ISO 8601 格式。
string
时间范围终点，ISO 8601 格式。
string
逗号分隔的分组维度。支持的取值：
user、model、entrypoint。响应
array
成本聚合行。
curl -X GET "https://router.example.com/v1/router/cost?from=2024-06-01T00:00:00Z&to=2024-06-30T23:59:59Z&group_by=user,model" \
-H "Authorization: Bearer <api-key>"
{
"items": [
{
"user": "user_a",
"model": "gpt-4o",
"cost_usd": 12.45,
"tokens": 41500
},
{
"user": "user_a",
"model": "claude-3-5-sonnet-20241022",
"cost_usd": 8.20,
"tokens": 27300
}
]
}
密钥、成本与重放
Router 成本聚合接口
从咏唱引擎 ROUTER 获取成本聚合数据，按用户、模型、入口点与时间段拆分。
curl -X GET "https://router.example.com/v1/router/cost?from=2024-06-01T00:00:00Z&to=2024-06-30T23:59:59Z&group_by=user,model" \
-H "Authorization: Bearer <api-key>"
{
"items": [
{
"user": "user_a",
"model": "gpt-4o",
"cost_usd": 12.45,
"tokens": 41500
},
{
"user": "user_a",
"model": "claude-3-5-sonnet-20241022",
"cost_usd": 8.20,
"tokens": 27300
}
]
}
成本接口返回来自咏唱引擎 ROUTER 的聚合推理成本指标。可用它分析在所选时间窗口内，跨用户、模型与入口点的支出模式。
结果可按你通过查询参数选择的维度分组。所有已认证调用者均可访问此接口。
Was this page helpful?