> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tramlabs.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tramlabs.io/_mcp/server.

# Ngân sách

> Set spending limits on workspaces, API keys, and projects

Ngân sách (budget) cho phép người dùng đặt giới hạn chi tiêu cho workspace, giúp kiểm soát chi phí sử dụng API.

## Cấu hình budget

Vào **Console → Guardrails → Budget** để thiết lập giới hạn ngân sách cho workspace.

Mỗi workspace có thể đặt:

* **Giới hạn chi tiêu (USD)** — Số tiền tối đa workspace được phép sử dụng
* **Chu kỳ reset** — Khi nào giới hạn được đặt lại:
  * `daily` — Reset mỗi ngày (nửa đêm giờ Việt Nam)
  * `weekly` — Reset mỗi tuần (thứ Hai)
  * `monthly` — Reset mỗi tháng (ngày 1)
  * `one-time` — Không reset, giới hạn áp dụng vĩnh viễn

## Cách hoạt động

Khi workspace vượt giới hạn budget, tất cả request API từ các key trong workspace đó sẽ bị chặn với lỗi `budget_exceeded`. Response trả về bao gồm thông tin:

* Số tiền đã chi (`spendUsd`)
* Giới hạn tối đa (`maxBudgetUsd`)
* Chu kỳ hiện tại (`period`)
* Thời điểm reset tiếp theo (`resetAt`)

Các vi phạm budget được ghi lại trong **Guardrails → Violations** để người dùng theo dõi.

## Xóa giới hạn

Để xóa giới hạn budget, tắt toggle budget trong trang cấu hình. Workspace sẽ không còn bị giới hạn chi tiêu.