> ## Documentation Index
> Fetch the complete documentation index at: https://docs.niadra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teto de gasto com IA

> O gasto de IA de hoje por finalidade contra o teto diário, do contrato ou padrão, e quando o trabalho que espera volta.



## OpenAPI

````yaml openapi/pt/cell.json GET /v1/usage/budget
openapi: 3.1.0
info:
  title: API de dados da Niadra
  version: '1'
  description: >-
    Escrita, contexto, histórico, objetos, identidade, privacidade e governança
    de um espaço. Cada espaço tem um endereço estável, com o espaço e a região
    no nome.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: O espaço, que vem na chave de fonte.
      region:
        default: us-east-2
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /v1/usage/budget:
    get:
      tags:
        - usage
      summary: Teto de gasto com IA
      description: >-
        O gasto de IA de hoje contra o teto diário do espaço, por finalidade: o
        teto do contrato ou o padrão.


        **Autenticação.** Token de pessoa do Console com o papel `analysis` (ou
        admin), ou chave de fonte com o escopo `admin`.
      operationId: llm_budget_v1_usage_budget_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BudgetReport'
              example:
                items:
                  - purpose: assistant
                    day: '2026-09-22'
                    cap_micros: 200000
                    from_contract: false
                    spent_micros: 41300
                    reached: false
                    resumes_at: null
                  - purpose: extraction
                    day: '2026-09-22'
                    cap_micros: 2000000
                    from_contract: true
                    spent_micros: 2004120
                    reached: true
                    resumes_at: '2026-09-23T00:00:00Z'
          description: 'Uma linha por finalidade: `extraction` e `assistant`.'
      security:
        - sourceKey: []
        - personToken: []
components:
  schemas:
    BudgetReport:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/BudgetLine'
          title: Items
          type: array
      required:
        - items
      title: BudgetReport
      type: object
    BudgetLine:
      additionalProperties: false
      properties:
        cap_micros:
          anyOf:
            - type: integer
            - type: 'null'
          description: O teto do dia, em milionésimos de dólar.
          title: Cap Micros
        day:
          description: O dia, em UTC, em que o gasto conta.
          format: date
          title: Day
          type: string
        from_contract:
          description: >-
            Verdadeiro quando o contrato define o teto; falso para o padrão da
            célula.
          title: From Contract
          type: boolean
        purpose:
          description: '`extraction` ou `assistant`.'
          title: Purpose
          type: string
        reached:
          description: O trabalho desta finalidade espera o dia seguinte em UTC.
          title: Reached
          type: boolean
        resumes_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Resumes At
        spent_micros:
          title: Spent Micros
          type: integer
      required:
        - purpose
        - day
        - cap_micros
        - from_contract
        - spent_micros
        - reached
      title: BudgetLine
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````