Genera un report sull'utilizzo stimato dei token di traduzione di un'organizzazione e sull'utilizzo in byte del database per tabella.
Segnala l'utilizzo stimato dei token di traduzione (per lingua) e l'utilizzo in byte del database per tabella per un'organizzazione WorkOS.
Autenticazione: Bearer JWT (WorkOS).
| Parametro | Tipo | Obbligatorio | Note |
|---|---|---|---|
orgId | uuid | sì | L'organizzazione WorkOS di cui generare il report. |
{
"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": "..."
}
}
Le conte dei token sono stime (un'euristica di circa 4 caratteri per token più un margine fisso per il system prompt per chiamata), non corrispondono alla fatturazione del provider. L'utilizzo del database somma pg_column_size per ogni tabella posseduta; i file binari delle immagini archiviati nello storage di oggetti non sono conteggiati. Nota la particolarità di serde: all'interno di byLanguage le chiavi dei token sono in snake_case (estimated_prompt_tokens, ecc.) mentre l'oggetto padre usa camelCase.
curl '{CMS_API_URL}/usage?orgId=<uuid>' \
-H 'Authorization: Bearer <workos-jwt>'
400 — orgId mancante o non valido401 — JWT mancante o non valido500 — errore nella query