GET /usage

Αναφέρει την εκτιμώμενη χρήση διακριτικών μετάφρασης (ανά γλώσσα) και τη χρήση byte βάσης δεδομένων ανά πίνακα ενός οργανισμού 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 χαρακτήρες ανά διακριτικό συν μια σταθερή επιβάρυνση προτροπής συστήματος ανά κλήση), όχι η χρέωση του παρόχου. Η χρήση βάσης δεδομένων αθροίζει το 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 — αποτυχία ερωτήματος