GET /usage

รายงานการใช้งานโทเค็นการแปลขององค์กร WorkOS ที่ ประมาณการ (จำแนกตามภาษา) พร้อมทั้งการใช้งานไบต์ของฐานข้อมูลในแต่ละตาราง

การตรวจสอบสิทธิ์: Bearer JWT (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": "documents", "rows": 42, "bytes": 500000 } ],
    "note": "..."
  }
}

จำนวนโทเค็นเป็นค่าประมาณ (ใช้ฮิวริสติกประมาณ ~4 อักขระต่อโทเค็น บวกกับโควตา system prompt ต่อการเรียกที่กำหนดไว้ตายตัว) ซึ่ง ไม่ใช่ ปริมาณการใช้งานที่ผู้ให้บริการเรียกเก็บจริง การใช้งานฐานข้อมูลคำนวณจากผลรวม pg_column_size ของแต่ละตารางที่เป็นเจ้าของ; ไบนารีของรูปภาพที่เก็บไว้ในที่เก็บวัตถุจะไม่นับรวม โปรดสังเกตข้อยกเว้นของ serde: ภายใน byLanguage คีย์ของโทเค็นจะเป็นรูปแบบ snake_case (estimated_prompt_tokens เป็นต้น) ในขณะที่อ็อบเจ็กต์พาเรนต์ใช้ camelCase

ตัวอย่าง

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

ข้อผิดพลาด

• 400 — ไม่มีหรือ orgId ไม่ถูกต้อง
• 401 — ไม่มีหรือ JWT ไม่ถูกต้อง
• 500 — การสืบค้นล้มเหลว