設定工作區速率限制

POST/v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id}

為工作區中的單一速率限制群組設定或清除速率限制覆寫。

只有 limits 中指定的限制器類型會變更：整數 value 會設定該類型的覆寫，而 null 會清除它。未指定的類型會保留其目前的值。高於組織自身限制的值會被儲存，但組織限制仍然適用，因此會強制執行兩者中較低者。

傳回套用此請求後的目標群組項目，其格式與 GET /v1/organizations/workspaces/{workspace_id}/rate_limits 傳回的格式相同。變更會在約一小時內生效。

Path parameters

workspace_id: string

The ID of the workspace.

rate_limit_id: string

The id of the organization's rate-limit entry to set overrides for.

Headers

"anthropic-version": optional string

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Body

limits: array of BetaWorkspaceRateLimitUpdateValue { type, value }

Limits to set or clear. Unspecified limit types are unchanged.

minItems1

maxItems16

type: BetaWorkspaceRateLimitType

Rate limiter type.

One of the following:

"fast_itpmca"

"fast_otpm"

"input_tokens_per_minute"

"input_tokens_per_minute_cache_aware"

"output_tokens_per_minute"

"requests_per_minute"

"tokens_per_day"

"tokens_per_minute"

"tool_uses_per_second"

value: number or null

New limit value. Set to null to clear the workspace override and fall back to the organization limit.

minimum0

maximum9007199254740991

Returns

BetaWorkspaceRateLimit object{ type: "workspace_rate_limit", group, group_type, 4 more }

設定工作區速率限制

curl https://api.anthropic.com/v1/organizations/workspaces/$WORKSPACE_ID/rate_limits/$RATE_LIMIT_ID \
    -H 'Content-Type: application/json' \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY" \
    -d '{
          "limits": [
            {
              "type": "fast_itpmca",
              "value": 0
            }
          ]
        }'

Response 200

{
  "group": {
    "id": "id",
    "display_name": "display_name",
    "type": "model_group"
  },
  "group_type": "batch",
  "limits": [
    {
      "org_limit": 0,
      "source": {
        "type": "workspace"
      },
      "type": "type",
      "value": 0
    }
  ],
  "models": [
    "string"
  ],
  "rate_limit_id": "rate_limit_id",
  "type": "workspace_rate_limit",
  "workspace_id": "workspace_id"
}

Returns Examples

Response 200

{
  "group": {
    "id": "id",
    "display_name": "display_name",
    "type": "model_group"
  },
  "group_type": "batch",
  "limits": [
    {
      "org_limit": 0,
      "source": {
        "type": "workspace"
      },
      "type": "type",
      "value": 0
    }
  ],
  "models": [
    "string"
  ],
  "rate_limit_id": "rate_limit_id",
  "type": "workspace_rate_limit",
  "workspace_id": "workspace_id"
}