报告组织的估算翻译令牌使用量和每个数据表的数据库字节使用量。
报告 WorkOS 组织按语言的估算翻译令牌使用量以及按表的数据库字节使用量。
认证： Bearer JWT（WorkOS）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orgId | uuid | 是 | 要生成报告的 WorkOS 组织。 |
{
"orgId": "...",
"translations": {
"translations": 120,
"estimatedPromptTokens": 45000,
"estimatedCompletionTokens": 42000,
"estimatedTotalTokens": 87000,
"byLanguage": [
{
"language": "fr",
"translations": 40,
"estimated_prompt_tokens": 15000,
"estimated_completion_tokens": 14000,
"estimated_total_tokens": 29000
}
],
"note": "..."
},
"database": {
"totalBytes": 1048576,
"totalHuman": "1.0 MB",
"byTable": [ { "table": "文档", "rows": 42, "bytes": 500000 } ],
"note": "..."
}
}
令牌计数是估算值（基于约每个令牌 4 个字符的启发式算法，加上每次调用固定的系统提示配额），并非提供商的计费用量。数据库使用量按所拥有的数据表汇总 pg_column_size；存储在对象存储中的图像二进制文件不计入。请注意序列化/反序列化的差异：在 byLanguage 内部，令牌相关键使用蛇形命名（estimated_prompt_tokens 等），而父对象使用驼峰命名。
curl '{CMS_API_URL}/usage?orgId=<uuid>' \
-H 'Authorization: Bearer <workos-jwt>'
400 — 缺少或无效的 orgId401 — 缺少或无效的 JWT500 — 查询失败