跳转到主要内容
POST
设置用量配置

概述

为你的组织设置或清除附加额度的每用户用量上限。上限始终按用户单独生效。当你指定团队或组作用域时,上限会单独应用于该团队或组中的每位用户——而不是为整个团队或组设置一个共享上限。

请求

service_key
string
必填
你的服务密钥,且具有“Billing Write”权限

额度上限配置 (任选其一)

clear_add_on_credit_cap
boolean
设为 true 以清除当前的附加额度上限
set_add_on_credit_cap
integer
设置新的附加额度上限 (整数值)
必须提供 clear_add_on_credit_capset_add_on_credit_cap 其中之一,但不能同时提供两者。

作用域配置 (任选其一)

team_level
boolean
设为 true,将对团队中的每位用户应用单用户上限
group_id
string
提供组 ID,将对特定组中的每位用户应用单用户上限
user_email
string
提供电子邮件地址,将该配置应用于特定用户
你必须提供 team_levelgroup_iduser_email 其中之一来定义作用域。

示例请求 - 为团队中的所有用户设置单用户信用额度上限

示例请求 - 为组中的所有用户设置每位用户的信用额度上限

示例请求 - 为用户设置额度上限

示例请求 - 取消信用额度上限

响应

响应体为空。200 状态码表示操作成功。

错误响应

常见错误场景:
  • 服务密钥无效或权限不足
  • 同时提供了 clear_add_on_credit_capset_add_on_credit_cap
  • 既未提供 clear_add_on_credit_cap,也未提供 set_add_on_credit_cap
  • 提供了多个作用域参数
  • 未提供作用域参数
  • 组 ID 或用户邮箱无效
  • 已超出速率限制