GET /usage

Fournit un rapport sur l'utilisation estimée des jetons de traduction (par langue) et l'utilisation en octets de la base de données par table d'une organisation WorkOS.

Auth : JWT Bearer (WorkOS).

Paramètres de requête

Réponse

{
  "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": "..."
  }
}

Les décomptes de jetons sont des estimations (une heuristique d'environ 4 caractères par jeton plus une allocation fixe de message système par appel), et ne correspondent pas à la facturation du fournisseur. L'utilisation de la base de données additionne pg_column_size pour chaque table détenue ; les binaires d'image stockés dans un stockage objet ne sont pas comptabilisés. Notez la particularité de sérialisation : à l'intérieur de byLanguage, les clés de jetons sont en snake_case (estimated_prompt_tokens, etc.), tandis que l'objet parent utilise du camelCase.

Exemple

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

Erreurs

• 400 — orgId manquant ou invalide
• 401 — JWT manquant ou invalide
• 500 — échec de la requête