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"
    }
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号