GET /usage

किसी WorkOS संगठन के अनुमानित अनुवाद टोकन उपयोग (भाषा के अनुसार) और प्रत्येक तालिका के अनुसार डेटाबेस बाइट उपयोग की रिपोर्ट करें।

प्रमाणीकरण: बेयरर 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 वर्णों के ह्यूरिस्टिक के साथ और प्रति कॉल स्थिर सिस्टम-प्रॉम्प्ट भत्ता जोड़कर), और यह प्रदाता द्वारा बिल की गई खपत नहीं है। डेटाबेस उपयोग स्वामित्व वाली प्रत्येक तालिका के लिए 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 — क्वेरी विफलता