Conta e uso

Conta atual

GET/v1/accountescopo: account:read

Retorna a identidade do usuário que faz a chamada — id, nome, e-mail, imagem, indicador de e-mail verificado e os escopos que o token atual carrega. Útil para verificar se uma chave recém-gerada funciona.

{
  "data": {
    "id": "user_…",
    "name": "Jane",
    "email": "jane@example.com",
    "emailVerified": true,
    "image": null,
    "createdAt": "2026-01-04T11:00:00.000Z",
    "auth": {
      "via": "token",
      "scopes": ["books:read", "books:write", "generation:run"]
    }
  }
}

Saldo de créditos

GET/v1/creditsescopo: account:read

Os créditos de geração restantes na conta. Confira antes de uma tarefa grande — endpoints pagos retornam 402 insufficient_credits (com o valor required) em vez de rodar quando o saldo não basta, e uma chave com teto mensal retorna 402 key_cap_exceeded quando o teto é atingido.

{ "data": { "credits": 412 } }

Resumo do uso de tokens

GET/v1/usageescopo: account:read

Gasto agregado de tokens de LLM na conta, agrupado por tipo de chamada (outline, chapter, rewrite, critique, continuity, research). Retorna os totais de todo o período e uma janela móvel de 30 dias, além de uma lista das 50 chamadas mais recentes para você identificar uma tarefa descontrolada.

{
  "data": {
    "lifetime": [
      { "kind": "chapter", "inputTokens": 184201, "outputTokens": 79018, "calls": 24 },
      { "kind": "outline", "inputTokens": 4012, "outputTokens": 2810, "calls": 3 }
    ],
    "last30Days": [ … ],
    "recentCalls": [
      { "bookId": "8f1c…", "kind": "chapter", "model": "claude-sonnet-4-6",
        "inputTokens": 7100, "outputTokens": 3500,
        "createdAt": "2026-05-31T13:48:11.000Z" }
    ]
  }
}