Usage
Consulte consumo por período, modelo, agent, session, projeto e metadados.
#Endpoints
| Método | Caminho | Descrição |
|---|---|---|
| GET | /v1/usage/summary | Totais agregados de tokens. |
| GET | /v1/usage/by-model | Quebra por modelo. |
| GET | /v1/usage/timeseries | Série temporal por granularidade. |
| GET | /v1/usage/meters | Agregação por meter. |
#Filtros
Todos os endpoints de usage exigem from e to em ISO datetime.
http
GET /v1/usage/summary?from=2026-06-01T00:00:00.000Z&to=2026-06-23T23:59:59.000Z&projectId=proj_...Filtros disponíveis:
| Filtro | Uso |
|---|---|
projectId | Restringe a um projeto. |
agentId | Restringe a um agent. |
sessionId | Restringe a uma session. |
metadata[chave] | Filtra por metadados de session. |
granularity | minute, hour, day ou month em timeseries. |