API des limites de débit

L'API des limites de débit fournit 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 des proxys : Lisez vos limites actuelles au démarrage et selon un calendrier défini au lieu de coder en dur des valeurs qui dérivent lorsque Anthropic les ajuste.
• Alimenter les alertes internes : Comparez les données d'utilisation provenant 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 pour 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 dans 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èles 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 qui compte dans les limites de ce groupe. Utilisez cette liste pour rechercher à quel groupe appartient une chaîne de modèle donnée. Pour les autres types de groupes, models est 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 savoir comment chaque limiteur est mesuré et appliqué.

Pour 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 pour un modèle spécifique

Passez n'importe quel ID de modèle ou alias comme paramètre de requête model pour renvoyer uniquement 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 unique.

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

• Un groupe absent de data n'a aucun remplacement d'espace de travail. L'espace de travail hérite des limites au niveau de l'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 au niveau de l'organisation pour le même limiteur, ou null si l'organisation n'a pas de limite configurée pour ce type de limiteur.

Pour 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 optionnel 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 est null. Bouclez sur next_page afin que votre client pagine correctement sans modifications 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 qui compte 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 pas de remplacement pour ce groupe et hérite de la limite au niveau de l'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