GET /usage

Báo cáo mức sử dụng mã thông báo dịch ước tính (theo ngôn ngữ) của tổ chức WorkOS và mức sử dụng byte cơ sở dữ liệu theo từng bảng.

Xác thực: Bearer JWT (WorkOS).

Tham số truy vấn

Phản hồi

{
  "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": "documents", "rows": 42, "bytes": 500000 } ],
    "note": "..."
  }
}

Số lượng mã thông báo là ước tính (theo kinh nghiệm ~4 ký tự mỗi mã thông báo cộng với mức cho phép nhắc hệ thống cố định cho mỗi lần gọi), không phải mức sử dụng được nhà cung cấp tính phí. Mức sử dụng cơ sở dữ liệu cộng dồn pg_column_size cho từng bảng thuộc sở hữu; các tệp nhị phân hình ảnh được lưu trong bộ nhớ đối tượng không được tính. Lưu ý điểm khác thường của serde: bên trong byLanguage, các khóa mã thông báo ở dạng snake_case (estimated_prompt_tokens, v.v.) trong khi đối tượng cha sử dụng camelCase.

Ví dụ

curl '{CMS_API_URL}/usage?orgId=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>'

Lỗi

• 400 — thiếu hoặc orgId không hợp lệ
• 401 — thiếu hoặc JWT không hợp lệ
• 500 — lỗi truy vấn