Setting Budgets and Alerts for Model Usage
When AI tools such as Claude Code, OpenClaw, Cursor, TRAE, and ZCode connect to MaaS, model usage incurs charges based on token consumption, video duration, or the number of images generated. However, agentic workflows often involve frequent model calls, unpredictable token consumption, and API keys shared by multiple users, which can drive up costs quickly. Abnormal usage, such as infinite loops or oversized context windows, can also lead to unexpected charges. In addition, the Individual Token Plan has usage limits. Once the quota is exhausted, services may be interrupted. To help control costs and prevent service interruptions, you can set budgets and alerts based on model usage. By defining usage and cost thresholds, you can monitor spending, detect abnormal usage, manage subscription quotas, track usage, and maintain service stability.
Constraints
Each user can create up to 100 budgets.
Each recipient can receive up to 100 budget alerts per day.
Budgets are monitored hourly, so actual costs or usage may exceed the budget before an alert is sent.
Enterprise master accounts that are not enrolled in financial management cannot set budgets for member accounts.
Step 1: Configure the Message Receiving Method
- Go to the Message Receiving Management page and select Finance.
- On the Finance page, configure the message receiving method and recipients for Cost Management notifications. Figure 1 Configuring the message receiving method
Step 2: Create a Model Usage Budget
- Go to the Budgets page and click Create Budget.
- On the Create Budget page, select Custom Budget and click Create Budget.
- Select Usage budget and click Next.
- Configure the usage budget by referring to the following table.
Table 1 Usage budget parameters Category
Parameter
Description
Example Value
Specify Budget Name
Budget Name
Enter a unique name for the budget.
Only letters, digits, hyphens (-), and underscores (_) are supported.
deepseek-v4-1-flash usage budget
Configure Budget Details
Usage Type
Select the type of usage to track for pay-per-use services.
MaaS supports billing items such as input tokens and output tokens.
CAUTION:After calling a model and incurring charges for a billing item, wait 2 to 4 hours for the corresponding usage type to appear.
Output tokens
Reset Period
Specify how often the budget is reset.
- Daily: The budget is tracked from 00:00 on the start date and reset at 00:00 every day.
- Monthly: The budget is tracked from the first day of the start month and reset at 00:00 on the first day of each month.
- Quarterly: The budget is tracked from the first day of the start quarter and reset at 00:00 on the first day of each quarter.
- Yearly: The budget is tracked from 00:00 on the start date and reset at 00:00 on January 1 each year.
Daily
Budget Duration
Recurring: Set Start Time to specify when the budget takes effect. The budget then remains recurring.
Expiring: Set Time Range to specify the budget's start and end times.
Recurring
Baseline Time Range
Currently, the following four rules are supported. For details, see Dynamic Budgeting.
- Last quarter/month actual
- Current quarter/month forecast
- Last several quarters/months average
- Last several quarters/months compound growth rate
-
Budgeted Usage
Set the budgeted usage based on your business needs. The unit is thousand tokens (K tokens).
1
Define Budget Scope
Specifications
Click Show more, select the models to include in the usage statistics, and click OK.
CAUTION:Only models that have been used are displayed. To include a model that has not yet been used, invoke the model and incur a charge. The model will appear in the list after 2 to 4 hours.
- MaaS model: Select ModelArts and then select a model. Figure 2 MaaS model
deepseek-v4.1-flash
Usage
By default, Pay-per-use is selected.
- Pay-per-use
- Packages
Pay-per-use
- Click Next. Toggle on Budget Alerts, and set the alert threshold and the recipients for receiving alerts.
Table 2 Parameters for creating a usage budget Parameter
Description
Example Value
Alerts
A maximum of five thresholds can be set for each budget.
An alert is sent when actual usage reaches a specified amount or percentage of the budgeted usage.
The threshold can be a certain usage or a certain percentage of the budgeted usage.
- Usage: If the actual usage reaches this value, an alert will be reported.
- (%) of budgeted usage: If the actual usage reaches a certain percentage of the budgeted usage, an alert will be reported.
An alert will be reported when the actual usage reaches 80% of the budgeted usage.
Recipients
The contacts who will receive alerts. The account contact is the default recipient. A maximum of 10 recipients can be added for each budget alert.
If you want to add or modify recipient information, go to the Message Receiving Management > Recipient Management page in the Message Center.
-
Figure 3 Setting alert thresholds and recipients
- Click Next, confirm the model usage budget settings, and click Save. The usage budget is created successfully.
- Click a budget name to view the actual usage, estimated usage, and budget history on the usage budget details page. Figure 4 Budget list
Figure 5 Usage budget details
Alert Notifications
- Alert notifications are sent between 8:00 and 21:00 Beijing Time. If an alert is triggered between 21:01 and 7:59 the following day, the notification is sent at 8:00 the next day.
- When the actual usage reaches an alert threshold, the system sends an alert notification through your configured message receiving method.
- You will typically receive a notification within one hour after the actual usage reaches the alert threshold. Each message recipient can receive a maximum of 100 budget alert notifications per day. Plan your budgets accordingly.
- If a budget meets multiple alert thresholds, only one alert notification is sent during each check.
Suppose you set the budgeted usage to 100 K tokens and thresholds to 60%, 70%, and 80%. If actual usage reaches 85 K tokens (85% of the budget), the system sends only one notification, indicating that usage has exceeded 80% of the budget.
- Each alert threshold triggers only one notification per reset period.
Suppose the reset period is monthly, the budgeted usage is 100 K tokens, and the threshold is 80%. When actual usage reaches 80 k tokens (80% of the budget), the system sends a notification.
If you change the threshold to 90% later in the same month, the system applies the new threshold. When actual usage reaches 90 k tokens (90% of the budget), another notification is sent.
FAQs
Q1: How do I set a budget for a custom endpoint?
An endpoint is not a billable item. Charges are based on the pricing items of the specific model invoked through the endpoint. Therefore, when setting a budget for an endpoint, select the model associated with that endpoint, rather than the endpoint itself.
Helpful Links
For details about how to set a budget, see Budgets.
What is your overall rating for this page?
Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot