通过 token 配额控制费用

控制台

1. 在 Google Cloud 控制台中，前往 IAM 和管理 > 配额和系统限制页面。

   进入“配额和系统限制”

2. 输入 Service: BigQuery API 以过滤配额。

3. 从配额列表中搜索特定配额，例如每天的 AI 输入 token 数 (GenAiInputTokensPerDay)，或对名称列进行排序，将 AI token 配额置于列表顶部。

4. 点击 more_vert 更多操作 > 修改配额。

5. 如需增加或减少配额，请在配额更改窗格的新值字段中输入新值，然后点击完成。降低配额会立即生效，无需审批。

6. 点击提交请求。

gcloud

使用 gcloud CLI 管理令牌配额时，请将 bigquery.googleapis.com 指定为服务名称，并使用以下区分大小写的配额 ID：

• 每天的 AI 输入 token 数：GenAiInputTokensPerDay
• 每位用户每天的 AI 输入 token 数：GenAiInputTokensPerUserPerDay
• 每天的 AI 输出 token 数：GenAiOutputTokensPerDay
• 每位用户每天的 AI 输出 token 数：GenAiOutputTokensPerUserPerDay

1. 可选：如需列出 BigQuery 生成式 AI 词元配额及其当前值，请使用 gcloud quotas info list：

   gcloud quotas info list \
       --service=bigquery.googleapis.com \
       --project=PROJECT_ID \
       --filter="quotaId:GenAi*"
   

2. 如需为每日 token 限额创建或更新配额偏好设置，请使用 gcloud quotas preferences update。以下示例会检查每个配额是否已存在配额偏好设置（例如，之前是否在Google Cloud 控制台中修改过），并更新或创建偏好设置：

   PROJECT_ID="PROJECT_ID"
   
   for ITEM in \
     "GenAiInputTokensPerDay:INPUT_TOKEN_LIMIT" \
     "GenAiOutputTokensPerDay:OUTPUT_TOKEN_LIMIT"; do
     QUOTA_ID="${ITEM%:*}"
     NEW_LIMIT="${ITEM#*:}"
   
     PREF_ID=$(gcloud quotas preferences list \
       --project="${PROJECT_ID}" \
       --filter="quotaId:${QUOTA_ID}" \
       --format="value(name.basename())")
     PREF_ID="${PREF_ID:-custom-${QUOTA_ID}}"
   
     gcloud quotas preferences update "${PREF_ID}" \
       --project="${PROJECT_ID}" \
       --service=bigquery.googleapis.com \
       --quota-id="${QUOTA_ID}" \
       --preferred-value="${NEW_LIMIT}" \
       --allow-high-percentage-quota-decrease \
       --allow-missing
   done
   

   替换以下内容：

   • PROJECT_ID：您的 Google Cloud 项目 ID。
   • INPUT_TOKEN_LIMIT：目标每日输入 token 限制（例如 754000000）。
   • OUTPUT_TOKEN_LIMIT：您的目标每日输出 token 限制（例如 8000000）。

   您还可以将以下可选标志与 gcloud quotas preferences update 搭配使用：

   • --allow-quota-decrease-below-usage：允许将配额限制降低到低于当天的当前用量。
   • --email：指定联系邮箱，在请求将配额提高到默认上限以上时，必须提供此邮箱。
   • --justification：提供配额调整的原因。

3. 如需验证配额偏好设置的状态，请使用 gcloud quotas preferences list：

   gcloud quotas preferences list \
       --project=PROJECT_ID \
       --filter="quotaId:GenAiInputTokensPerDay OR quotaId:GenAiOutputTokensPerDay"
   

   当 reconciling 为 false 时，系统会主动强制执行 grantedValue 中的值。

Python

使用适用于 Python 的 Cloud Quotas 客户端库管理 token 配额时，请将 bigquery.googleapis.com 指定为服务名称，并使用以下区分大小写的配额 ID：

• 每天的 AI 输入 token 数：GenAiInputTokensPerDay
• 每位用户每天的 AI 输入 token 数：GenAiInputTokensPerUserPerDay
• 每天的 AI 输出 token 数：GenAiOutputTokensPerDay
• 每位用户每天的 AI 输出 token 数：GenAiOutputTokensPerUserPerDay

1. 安装 Python 版 Cloud Quotas 客户端库：

   pip install --user google-cloud-quotas
   

2. 如需检查现有配额偏好设置资源并创建或更新每日 token 限制，请运行以下 Python 脚本：

   from google.cloud import cloudquotas_v1
   
   PROJECT_ID = "PROJECT_ID"
   QUOTA_LIMITS = {
       "GenAiInputTokensPerDay": INPUT_TOKEN_LIMIT,
       "GenAiOutputTokensPerDay": OUTPUT_TOKEN_LIMIT,
   }
   
   # Initialize the client with quota_project_id (required by the Cloud Quotas API).
   client = cloudquotas_v1.CloudQuotasClient(
       client_options={"quota_project_id": PROJECT_ID}
   )
   parent = f"projects/{PROJECT_ID}/locations/global"
   
   for quota_id, new_limit in QUOTA_LIMITS.items():
       # Check for an existing preference ID, or fall back to a default name.
       list_request = cloudquotas_v1.ListQuotaPreferencesRequest(
           parent=parent,
           filter=f"quotaId:{quota_id}",
       )
       prefs = list(client.list_quota_preferences(request=list_request))
       pref_name = (
           prefs[0].name
           if prefs
           else f"{parent}/quotaPreferences/custom-{quota_id}"
       )
   
       # Update the existing preference or create it if missing (allow_missing=True).
       update_request = cloudquotas_v1.UpdateQuotaPreferenceRequest(
           quota_preference=cloudquotas_v1.QuotaPreference(
               name=pref_name,
               service="bigquery.googleapis.com",
               quota_id=quota_id,
               quota_config=cloudquotas_v1.QuotaConfig(preferred_value=new_limit),
           ),
           allow_missing=True,
           ignore_safety_checks=[
               cloudquotas_v1.QuotaSafetyCheck.QUOTA_DECREASE_PERCENTAGE_TOO_HIGH
           ],
       )
       response = client.update_quota_preference(request=update_request)
       print(f"Quota ID: {quota_id}")
       print(f"Preference Name: {response.name}")
       print(f"Preferred Value: {response.quota_config.preferred_value}")
       print(f"Granted Value: {response.quota_config.granted_value}")
       print(f"Reconciling: {response.reconciling}\n")
   

   替换以下内容：

   • PROJECT_ID：您的 Google Cloud 项目 ID。
   • INPUT_TOKEN_LIMIT：目标每日输入 token 限制，以整数表示（例如 754000000）。
   • OUTPUT_TOKEN_LIMIT：目标每日输出 token 限制，以整数表示（例如 8000000）。

Terraform

使用 Terraform 管理令牌配额时，请将 bigquery.googleapis.com 指定为服务名称，并使用以下区分大小写的配额 ID：

• 每天的 AI 输入 token 数：GenAiInputTokensPerDay
• 每位用户每天的 AI 输入 token 数：GenAiInputTokensPerUserPerDay
• 每天的 AI 输出 token 数：GenAiOutputTokensPerDay
• 每位用户每天的 AI 输出 token 数：GenAiOutputTokensPerUserPerDay

1. 检查您的项目是否已存在配额偏好设置。 Cloud Quotas 仅允许每个项目的每个配额有一个偏好设置资源。如果之前在Google Cloud 控制台或其他工具中修改过配额，则必须使用其现有的偏好设置 ID：

   gcloud quotas preferences list \
       --project=PROJECT_ID \
       --filter="quotaId:GenAiInputTokensPerDay OR quotaId:GenAiOutputTokensPerDay" \
       --format="table(quotaId, name.basename():label=PREFERENCE_ID, quotaConfig.preferredValue)"
   

2. 如需在 Terraform 配置（例如 main.tf）中配置每日令牌限额，请使用 google_cloud_quotas_quota_preference 资源：

   terraform {
     required_providers {
       google = {
         source  = "hashicorp/google"
         version = ">= 5.30.0"
       }
     }
   }
   
   locals {
     project_id = "PROJECT_ID"
   
     # If you previously modified a quota in the console or another
     # tool, replace `name` with the existing PREFERENCE_ID from
     # `gcloud quotas preferences list` and uncomment the `import` block.
     bq_genai_quotas = {
       GenAiInputTokensPerDay = {
         name            = "custom-GenAiInputTokensPerDay"
         preferred_value = "INPUT_TOKEN_LIMIT" # Default: 200,000,000,000
       }
       GenAiOutputTokensPerDay = {
         name            = "custom-GenAiOutputTokensPerDay"
         preferred_value = "OUTPUT_TOKEN_LIMIT" # Default: 20,000,000,000
       }
     }
   }
   
   # If quota preferences already exist on your project, uncomment this `import`
   # block so that Terraform imports the existing preferences instead of
   # attempting to create duplicates.
   #
   # import {
   #   for_each = local.bq_genai_quotas
   #   to       = google_cloud_quotas_quota_preference.bq_genai[each.key]
   #   id       = "projects/${local.project_id}/locations/global/quotaPreferences/${each.value.name}"
   # }
   
   resource "google_cloud_quotas_quota_preference" "bq_genai" {
     for_each      = local.bq_genai_quotas
     parent        = "projects/${local.project_id}"
     name          = each.value.name
     service       = "bigquery.googleapis.com"
     quota_id      = each.key
     justification = "Managing BigQuery GenAI daily token budget"
   
     # Allows decreases greater than 10% when setting a stricter cost cap.
     ignore_safety_checks = "QUOTA_DECREASE_PERCENTAGE_TOO_HIGH"
   
     quota_config {
       preferred_value = each.value.preferred_value
     }
   }
   
   output "quota_status" {
     value = {
       for k, v in google_cloud_quotas_quota_preference.bq_genai : k => {
         preferred_value = v.quota_config[0].preferred_value
         granted_value   = v.quota_config[0].granted_value
         reconciling     = v.reconciling
       }
     }
   }
   

   替换以下内容：

   • PROJECT_ID：您的 Google Cloud 项目 ID。
   • INPUT_TOKEN_LIMIT：目标每日输入 token 限制（例如 754000000）。
   • OUTPUT_TOKEN_LIMIT：您的目标每日输出 token 限制（例如 8000000）。

3. 初始化并应用 Terraform 配置：

   terraform init
   terraform apply