Rate Limits API

Rate Limits API menyediakan akses terprogram ke "rate limits" (batas laju) yang dikonfigurasi untuk organisasi Anda dan workspace-nya. Ini adalah informasi yang sama yang ditampilkan pada halaman Limits di Claude Console.

Gunakan API ini untuk:

• Menjaga gateway dan proxy tetap sinkron: Baca batas Anda saat ini pada saat startup dan sesuai jadwal alih-alih melakukan hardcoding nilai yang bisa berubah ketika Anthropic menyesuaikannya.
• Mendukung peringatan internal: Bandingkan data penggunaan dari Usage and Cost API dengan batas yang Anda konfigurasikan.
• Mengaudit konfigurasi workspace: Verifikasi bahwa override workspace sesuai dengan yang diharapkan oleh otomatisasi provisioning Anda.



Mulai cepat

Daftar batas laju yang dikonfigurasi untuk organisasi Anda:

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Batas laju organisasi

Endpoint /v1/organizations/rate_limits mengembalikan batas laju yang diterapkan pada tingkat organisasi untuk Messages API dan sumber daya pendukungnya. Batas untuk produk lain, seperti Claude Managed Agents, tidak disertakan.



Konsep utama

• Grup batas laju: Setiap entri dalam respons mewakili satu grup batas laju. Batas laju model dikelompokkan sehingga beberapa versi model berbagi satu set batas, dan grup lain mencakup sumber daya seperti Message Batches API, Files API, Token Counting API, agent skills, dan alat pencarian web.
• group_type: Mengidentifikasi kategori batas yang dicakup oleh entri tersebut. Lihat Memfilter berdasarkan tipe grup untuk daftar nilainya.
• Daftar models: Untuk entri model_group, field models mencantumkan setiap ID model dan alias yang dihitung terhadap batas grup tersebut. Gunakan daftar ini untuk mencari grup mana yang mencakup string model apa pun. Untuk tipe grup lainnya, models bernilai null.
• Daftar limits: Setiap grup membawa daftar pasangan {type, value}. Field type mengidentifikasi pembatas (seperti requests_per_minute, input_tokens_per_minute, atau output_tokens_per_minute) dan value adalah batas yang dikonfigurasi. Lihat Batas laju untuk cara setiap pembatas diukur dan diberlakukan.

Untuk detail parameter lengkap dan skema respons, lihat referensi Organization Rate Limits API.



Mendaftar semua batas laju organisasi

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "batch",
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}



Mencari batas untuk model tertentu

Berikan ID model atau alias apa pun sebagai parameter kueri model untuk mengembalikan hanya entri yang memuatnya:

curl "https://api.anthropic.com/v1/organizations/rate_limits?model=claude-opus-5" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Jika string model tidak cocok dengan grup mana pun, endpoint mengembalikan error 404. Parameter model hanya didukung pada endpoint organisasi; endpoint workspace tidak menerimanya.



Batas laju workspace

Endpoint /v1/organizations/workspaces/{workspace_id}/rate_limits mengembalikan override batas laju yang dikonfigurasi untuk satu workspace.

Respons hanya menyertakan override, sehingga apa pun yang tidak ada di dalamnya diwarisi dari organisasi:

• Grup yang tidak ada dalam data sama sekali tidak memiliki override workspace. Workspace mewarisi batas tingkat organisasi untuk grup tersebut (bukan berarti tidak terbatas).
• Dalam grup yang ada, tipe pembatas yang tidak ada dalam limits[] tidak memiliki override workspace untuk pembatas tersebut. Workspace mewarisi nilai organisasi untuknya.
• Untuk setiap pembatas yang ada, org_limit adalah nilai tingkat organisasi untuk pembatas yang sama, atau null jika organisasi tidak memiliki batas yang dikonfigurasi untuk tipe pembatas tersebut.

Untuk detail parameter lengkap dan skema respons, lihat referensi Workspace Rate Limits API.

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    },
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    }
  ],
  "next_page": null
}



Memfilter berdasarkan tipe grup

Kedua endpoint menerima parameter kueri opsional group_type yang membatasi respons ke satu kategori:

curl "https://api.anthropic.com/v1/organizations/rate_limits?group_type=batch" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Nilai yang valid adalah model_group, batch, token_count, files, skills, dan web_search.



Paginasi

Kedua endpoint menerima parameter kueri page dan mengembalikan field next_page. Respons saat ini selalu berupa satu halaman, sehingga next_page bernilai null. Lakukan loop pada next_page agar klien Anda melakukan paginasi dengan benar tanpa perubahan ketika respons bertambah besar.



Pertanyaan yang sering diajukan



String model mana yang muncul dalam daftar models?

Setiap ID model dan alias yang dihitung terhadap grup, termasuk ID bertanggal (seperti claude-sonnet-4-5-20250929) dan alias tanpa tanggal (seperti claude-sonnet-4-5). Cari string model apa pun yang Anda berikan ke Messages API dan Anda akan menemukannya tepat di satu entri model_group.



Apa artinya jika sebuah grup tidak ada dalam respons workspace?

Workspace tidak memiliki override untuk grup tersebut dan mewarisi batas tingkat organisasi. Kueri endpoint organisasi untuk melihat nilai yang diwarisi.



Dapatkah saya memperbarui batas laju dengan API ini?

Tidak. Untuk mengatur batas laju workspace, buka workspace di Claude Console dan gunakan tab Limits.



Lihat juga

• Batas laju
• Admin API
• Referensi Admin API
• Workspaces
• Usage and Cost API