OpenAI 更新组织支出上限
2026-11-18 10:54 更新
更新组织支出上限
post /organization/spend_limit
创建或替换组织的硬性支出上限。
请求体参数
内容类型:application/json
currency: "USD"
阈值金额所用的币种。目前仅支持 USD。
"USD"
interval: "month"
用于评估支出是否达到阈值的时间区间。目前仅支持 month。
"month"
threshold_amount: integer
硬性支出上限金额,单位为美分。
minimum: 1
返回值
OrganizationSpendLimit object { currency, enforcement, interval, 2 more }
表示在组织级别配置的硬性支出上限。
currency: string or "USD"
阈值金额所用的币种。目前仅支持 USD。
string
"USD"
阈值金额所用的币种。目前仅支持 USD。
"USD"
enforcement: object { status }
硬性支出上限当前的执行状态。
status: string or "inactive" or "enforcing"
硬性支出上限当前是否正在执行。
string
"inactive" or "enforcing"
硬性支出上限当前是否正在执行。
"inactive"
"enforcing"
interval: string or "month"
用于评估支出是否达到阈值的时间区间。目前仅支持 month。
string
"month"
用于评估支出是否达到阈值的时间区间。目前仅支持 month。
"month"
object: "organization.spend_limit" (default: "organization.spend_limit")
对象类型,固定为 organization.spend_limit。
"organization.spend_limit"
threshold_amount: integer
硬性支出上限金额,单位为美分。
示例
## 读取管理员密钥。提交前核对组织与阈值,金额单位为美分
curl "https://api.openai.com/v1/organization/spend_limit" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-d '{
"currency": "USD",
"interval": "month",
"threshold_amount": 1
}'
200 — 示例
官方通用响应示例用于展示字段结构,其中阈值和执行状态与紧邻的请求示例不同。后面的具体示例展示将阈值设为 10,000 美分时的响应。
{
"currency": "USD",
"enforcement": {
"status": "inactive"
},
"interval": "month",
"object": "organization.spend_limit",
"threshold_amount": 0
}
示例
## 读取管理员密钥。提交前核对组织与阈值,金额单位为美分
curl -X POST "https://api.openai.com/v1/organization/spend_limit" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json" \
-d '{
"threshold_amount": 10000,
"currency": "USD",
"interval": "month"
}'
响应示例
{
"object": "organization.spend_limit",
"threshold_amount": 10000,
"currency": "USD",
"interval": "month",
"enforcement": {
"status": "enforcing"
}
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: