速率限制

列出组织速率限制

get /v1/organizations/rate_limits

列出您组织的 Messages API 速率限制。

每个条目对应一个速率限制组（模型系列或 API 表面类别，如 Files API 或 Message Batches）， 并包含适用于该组的限制值集合。

查询参数

• group_type: optional "model_group" or "batch" or "token_count" or 3 more

  按组类型筛选。

  • "model_group"

  • "batch"

  • "token_count"

  • "files"

  • "skills"

  • "web_search"

• model: optional string

  筛选包含此模型的单个条目。接受完整模型名称和别名。如果未找到模型或该组织没有该模型的速率限制，则返回 404。

• page: optional string

  来自上一次响应 next_page 的不透明游标。

返回值

• data: array of object { group_type, limits, models, type }

  组织的速率限制条目，每组一个。

  • group_type: "model_group" or "batch" or "token_count" or 3 more

    此条目表示的速率限制组类型。model_group 条目适用于模型系列（列在 models 中）；其他值适用于 API 表面类别，models 设置为 null。

    • "model_group"

    • "batch"

    • "token_count"

    • "files"

    • "skills"

    • "web_search"

  • limits: array of object { type, value }

    适用于此组的限制值。

    • type: string

      限制器类型（例如 requests_per_minute 或 input_tokens_per_minute）。

    • value: number

      此限制器类型的已配置限制值。

  • models: array of string

    此条目限制适用的模型名称，包括别名。当 group_type 不是 "model_group" 时为 null。

  • type: "rate_limit"

    对象类型。对于组织速率限制条目，始终为 rate_limit。

    • "rate_limit"

• next_page: string

  在后续请求中作为 page 提供的令牌，用于检索下一页数据。

示例

curl https://api.anthropic.com/v1/organizations/rate_limits \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_ADMIN_API_KEY"

响应

{
  "data": [
    {
      "group_type": "model_group",
      "limits": [
        {
          "type": "type",
          "value": 0
        }
      ],
      "models": [
        "string"
      ],
      "type": "rate_limit"
    }
  ],
  "next_page": "next_page"
}

领域类型

速率限制列表响应

• RateLimitListResponse object { data, next_page }

  • data: array of object { group_type, limits, models, type }

    组织的速率限制条目，每组一个。

    • group_type: "model_group" or "batch" or "token_count" or 3 more

      此条目表示的速率限制组类型。model_group 条目适用于模型系列（列在 models 中）；其他值适用于 API 表面类别，models 设置为 null。

      • "model_group"

      • "batch"

      • "token_count"

      • "files"

      • "skills"

      • "web_search"

    • limits: array of object { type, value }

      适用于此组的限制值。

      • type: string

        限制器类型（例如 requests_per_minute 或 input_tokens_per_minute）。

      • value: number

        此限制器类型的已配置限制值。

    • models: array of string

      此条目限制适用的模型名称，包括别名。当 group_type 不是 "model_group" 时为 null。

    • type: "rate_limit"

      对象类型。对于组织速率限制条目，始终为 rate_limit。

      • "rate_limit"

  • next_page: string

    在后续请求中作为 page 提供的令牌，用于检索下一页数据。