Help Center/ MaaS/ Calling Statistics & Performance Monitoring/ Setting Budgets and Alerts for Model Usage
Updated on 2026-11-13 GMT+08:00

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

  1. Go to the Message Receiving Management page and select Finance.
  2. 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

  1. Go to the Budgets page and click Create Budget.
  2. On the Create Budget page, select Custom Budget and click Create Budget.
  3. Select Usage budget and click Next.
  4. 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

  5. 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

  6. Click Next, confirm the model usage budget settings, and click Save. The usage budget is created successfully.
  7. 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.