Saltar para a documentação
API

Ler o histórico de utilização

Os envios e as ações de IA por dia, e o que custam por mês os extras do pagamento por utilização.

GET/billing/usage

Executa a chamada real no seu espaço de trabalho.

GET /billing/usage

Os envios e as ações de IA por dia, e o que custam por mês os extras do pagamento por utilização.

Exemplo

Requer billing:read. days recua de 1 a 3660 dias, 30 por omissão, e all recua até ao dia em que o espaço de trabalho foi criado. aiExtra conta as ações de IA acima da quota diária, que o pagamento por utilização faturou.

curl
curl "$OE/billing/usage?days=7" -H "$AUTH"
Resposta
{  "object": "usage_history",  "days": [    { "day": "2026-10-02", "aiActions": 14, "aiExtra": 0, "sends": 2210 },    { "day": "2026-10-03", "aiActions": 9, "aiExtra": 0, "sends": 1870 }  ],  "months": [    {      "month": "2026-09",      "extraSends": 3000,      "extraAiActions": 0,      "sendCents": 120,      "aiCents": 0,      "cents": 120    }  ],  "dailyAiActions": 150,  "monthlySends": 200000}

Só o proprietário do espaço de trabalho chega à faturação: uma chave de API, ou um token de acesso que o proprietário ligou com todos os endereços. O token de um membro dá um 403 owner_only, e uma chave ou um token limitado a certos endereços ou domínios dá um 422 capability_unsupported.

Referência