API des limites de débit

L'API des limites de débit offre un accès programmatique aux limites de débit configurées pour votre organisation et ses espaces de travail. Il s'agit des mêmes informations que celles affichées sur la page Limits dans la Claude Console.

Utilisez cette API pour :

• Maintenir la synchronisation des passerelles et proxys : Lisez vos limites actuelles au démarrage et selon un calendrier défini, plutôt que de coder en dur des valeurs qui dérivent lorsque Anthropic les ajuste.
• Alimenter les alertes internes : Comparez les données d'utilisation issues de l'API d'utilisation et de coût avec vos limites configurées.
• Auditer la configuration des espaces de travail : Vérifiez que les remplacements d'espace de travail correspondent à ce que votre automatisation de provisionnement attend.



Démarrage rapide

Listez les limites de débit configurées pour votre organisation :

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



Limites de débit de l'organisation

Le point de terminaison /v1/organizations/rate_limits renvoie les limites de débit appliquées au niveau de l'organisation pour l'API Messages et ses ressources associées. Les limites d'autres produits, tels que les agents gérés Claude, ne sont pas incluses.



Concepts clés

• Groupes de limites de débit : Chaque entrée de la réponse représente un groupe de limites de débit. Les limites de débit des modèles sont regroupées de sorte que plusieurs versions de modèle partagent un même ensemble de limites, et d'autres groupes couvrent des ressources telles que l'API Message Batches, l'API Files, l'API Token Counting, les compétences d'agent et l'outil de recherche web.
• group_type : Identifie la catégorie de limites couverte par l'entrée. Consultez Filtrage par type de groupe pour la liste des valeurs.
• Liste models : Pour les entrées model_group, le champ models liste chaque ID de modèle et alias comptabilisé dans les limites de ce groupe. Utilisez cette liste pour déterminer à quel groupe appartient une chaîne de modèle donnée. Pour les autres types de groupe, models vaut null.
• Liste limits : Chaque groupe contient une liste de paires {type, value}. Le champ type identifie le limiteur (tel que requests_per_minute, input_tokens_per_minute ou output_tokens_per_minute) et value est la limite configurée. Consultez Limites de débit pour comprendre comment chaque limiteur est mesuré et appliqué.

Pour obtenir les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API des limites de débit de l'organisation.



Lister toutes les limites de débit de l'organisation

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-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
}



Rechercher les limites d'un modèle spécifique

Passez n'importe quel ID de modèle ou alias comme paramètre de requête model pour ne renvoyer que l'entrée qui le contient :

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

Si la chaîne de modèle ne correspond à aucun groupe, le point de terminaison renvoie une erreur 404. Le paramètre model est pris en charge uniquement sur le point de terminaison de l'organisation ; le point de terminaison de l'espace de travail ne l'accepte pas.



Limites de débit de l'espace de travail

Le point de terminaison /v1/organizations/workspaces/{workspace_id}/rate_limits renvoie les remplacements de limites de débit configurés pour un espace de travail donné.

La réponse n'inclut que les remplacements ; tout ce qui en est absent est donc hérité de l'organisation :

• Un groupe absent de data n'a aucun remplacement au niveau de l'espace de travail. L'espace de travail hérite des limites de niveau organisation pour ce groupe (il n'est pas illimité).
• Au sein d'un groupe présent, un type de limiteur absent de limits[] n'a pas de remplacement d'espace de travail pour ce limiteur. L'espace de travail hérite de la valeur de l'organisation pour celui-ci.
• Pour chaque limiteur présent, org_limit est la valeur de niveau organisation pour le même limiteur, ou null si l'organisation n'a pas de limite configurée pour ce type de limiteur.

Pour obtenir les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API des limites de débit de l'espace de travail.

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-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
}



Filtrage par type de groupe

Les deux points de terminaison acceptent un paramètre de requête facultatif group_type qui restreint la réponse à une seule catégorie :

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"

Les valeurs valides sont model_group, batch, token_count, files, skills et web_search.



Pagination

Les deux points de terminaison acceptent un paramètre de requête page et renvoient un champ next_page. Les réponses tiennent actuellement toujours sur une seule page, donc next_page vaut null. Bouclez sur next_page afin que votre client pagine correctement sans modification lorsque la réponse s'agrandira.



Questions fréquentes



Quelles chaînes de modèle apparaissent dans la liste models ?

Chaque ID de modèle et alias comptabilisé dans le groupe, y compris les ID datés (tels que claude-sonnet-4-5-20250929) et les alias non datés (tels que claude-sonnet-4-5). Recherchez n'importe quelle chaîne de modèle que vous passez à l'API Messages et vous la trouverez dans exactement une entrée model_group.



Que signifie l'absence d'un groupe dans la réponse de l'espace de travail ?

L'espace de travail n'a aucun remplacement pour ce groupe et hérite de la limite de niveau organisation. Interrogez le point de terminaison de l'organisation pour voir les valeurs héritées.



Puis-je mettre à jour les limites de débit avec cette API ?

Non. Pour définir les limites de débit d'un espace de travail, ouvrez l'espace de travail dans la Claude Console et utilisez l'onglet Limits.



Voir aussi

• Limites de débit
• API d'administration
• Référence de l'API d'administration
• Espaces de travail
• API d'utilisation et de coût