Ngân sách

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.