Claude dans Microsoft Foundry

Ce guide vous explique comment configurer et effectuer des appels API à Claude dans Foundry en Python, TypeScript ou en utilisant des requêtes HTTP directes. Lorsque vous pouvez accéder à Claude dans Foundry, vous êtes facturé pour l'utilisation de Claude sur la Place de marché Microsoft avec votre abonnement Azure, ce qui vous permet d'accéder aux dernières capacités de Claude tout en gérant les coûts via votre abonnement Azure.

Disponibilité régionale : Au lancement, Claude est disponible en tant que type de déploiement Global Standard dans les ressources Foundry (US DataZone à venir bientôt). La tarification de Claude sur la Place de marché Microsoft utilise la tarification API standard d'Anthropic. Visitez la page de tarification pour plus de détails.

Aperçu

Dans cette intégration de plateforme en aperçu, les modèles Claude s'exécutent sur l'infrastructure d'Anthropic. Il s'agit d'une intégration commerciale pour la facturation et l'accès via Azure. En tant que processeur indépendant pour Microsoft, les clients utilisant Claude via Microsoft Foundry sont soumis aux conditions d'utilisation des données d'Anthropic. Anthropic continue de fournir ses engagements en matière de sécurité et de données de premier plan, y compris la disponibilité de zéro rétention de données.

Conditions préalables

Avant de commencer, assurez-vous que vous avez :

• Un abonnement Azure actif
• Accès à Foundry
• L'Azure CLI installée (facultatif, pour la gestion des ressources)

Installer un SDK

Les SDK clients d'Anthropic prennent en charge Foundry via des packages spécifiques à la plateforme.

Approvisionnement

Foundry utilise une hiérarchie à deux niveaux : les ressources contiennent votre configuration de sécurité et de facturation, tandis que les déploiements sont les instances de modèle que vous appelez via l'API. Vous allez d'abord créer une ressource Foundry, puis créer un ou plusieurs déploiements Claude dans celle-ci.

Approvisionnement des ressources Foundry

Créez une ressource Foundry, qui est requise pour utiliser et gérer les services dans Azure. Vous pouvez suivre ces instructions pour créer une ressource Foundry. Vous pouvez également commencer par créer un projet Foundry, ce qui implique de créer une ressource Foundry.

Pour approvisionner votre ressource :

1. Accédez au portail Foundry
2. Créez une nouvelle ressource Foundry ou sélectionnez-en une existante
3. Configurez la gestion des accès à l'aide de clés API émises par Azure ou d'Entra ID pour le contrôle d'accès basé sur les rôles
4. Configurez éventuellement la ressource pour qu'elle fasse partie d'un réseau privé (Réseau virtuel Azure) pour une sécurité renforcée
5. Notez le nom de votre ressource. Vous l'utiliserez comme {resource} dans les points de terminaison API (par exemple, https://{resource}.services.ai.azure.com/anthropic/v1/*)

Création de déploiements Foundry

Après avoir créé votre ressource, déployez un modèle Claude pour le rendre disponible pour les appels API :

1. Dans le portail Foundry, accédez à votre ressource
2. Allez à Modèles + points de terminaison et sélectionnez + Déployer le modèle > Déployer le modèle de base
3. Recherchez et sélectionnez un modèle Claude (par exemple, claude-sonnet-4-6)
4. Configurez les paramètres de déploiement :
   • Nom du déploiement : Par défaut, le nom du modèle, mais vous pouvez le personnaliser (par exemple, my-claude-deployment). Le nom du déploiement ne peut pas être modifié après sa création.
   • Type de déploiement : Sélectionnez Global Standard (recommandé pour Claude)
5. Sélectionnez Déployer et attendez que l'approvisionnement soit terminé
6. Une fois déployé, vous pouvez trouver votre URL de point de terminaison et vos clés sous Clés et point de terminaison

Authentification

Claude sur Foundry prend en charge deux méthodes d'authentification : les clés API et les jetons Entra ID. Les deux méthodes utilisent des points de terminaison hébergés par Azure au format https://{resource}.services.ai.azure.com/anthropic/v1/*.

Authentification par clé API

Après avoir approvisionné votre ressource Claude Foundry, vous pouvez obtenir une clé API à partir du portail Foundry :

1. Accédez à votre ressource dans le portail Foundry
2. Allez à la section Clés et point de terminaison
3. Copiez l'une des clés API fournies
4. Utilisez l'en-tête api-key ou x-api-key dans vos requêtes, ou fournissez-le au SDK

Les SDK Python et TypeScript nécessitent une clé API et soit un nom de ressource, soit une URL de base. Les SDK liront automatiquement ces éléments à partir des variables d'environnement suivantes s'ils sont définis :

• ANTHROPIC_FOUNDRY_API_KEY - Votre clé API
• ANTHROPIC_FOUNDRY_RESOURCE - Le nom de votre ressource (par exemple, example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL - Alternative au nom de ressource ; l'URL de base complète (par exemple, https://example-resource.services.ai.azure.com/anthropic/)

Exemple utilisant une clé API :

Authentification Microsoft Entra

Pour une sécurité renforcée et une gestion centralisée des accès, vous pouvez utiliser les jetons Entra ID (anciennement Azure Active Directory) :

1. Activez l'authentification Entra pour votre ressource Foundry
2. Obtenez un jeton d'accès à partir d'Entra ID
3. Utilisez le jeton dans l'en-tête Authorization: Bearer {TOKEN}

Exemple utilisant Entra ID :

ID de requête de corrélation

Foundry inclut des identifiants de requête dans les en-têtes de réponse HTTP pour le débogage et le suivi. Lorsque vous contactez le support, fournissez les valeurs request-id et apim-request-id pour aider les équipes à localiser et enquêter rapidement sur votre requête dans les systèmes d'Anthropic et d'Azure.

Fonctionnalités prises en charge

Claude sur Foundry prend en charge la plupart des puissantes fonctionnalités de Claude. Vous pouvez trouver toutes les fonctionnalités actuellement prises en charge dans la documentation d'aperçu.

Fenêtre de contexte

Claude Opus 4.7, Claude Opus 4.6 et Claude Sonnet 4.6 ont une fenêtre de contexte de 1M de jetons sur Microsoft Foundry. Les autres modèles Claude, y compris Sonnet 4.5, ont une fenêtre de contexte de 200k jetons.

Fonctionnalités non prises en charge

• Admin API (points de terminaison /v1/organizations/*)
• Models API (/v1/models)
• Message Batch API (/v1/messages/batches)

Réponses API

Les réponses API de Claude sur Foundry suivent le format de réponse API Claude standard. Cela inclut l'objet usage dans les corps de réponse, qui fournit des informations détaillées sur la consommation de jetons pour vos requêtes. L'objet usage est cohérent sur toutes les plateformes (API propriétaire, Foundry, Amazon Bedrock et Google Vertex AI).

Pour plus de détails sur les en-têtes de réponse spécifiques à Foundry, consultez la section ID de requête de corrélation.

ID de modèle API et déploiements

Les modèles Claude suivants sont disponibles via Foundry. Les modèles de dernière génération (Opus 4.7, Opus 4.6, Sonnet 4.6 et Haiku 4.5) offrent les capacités les plus avancées :

Par défaut, les noms de déploiement correspondent aux ID de modèle affichés ci-dessus. Cependant, vous pouvez créer des déploiements personnalisés avec des noms différents dans le portail Foundry pour gérer différentes configurations, versions ou limites de débit. Utilisez le nom du déploiement (pas nécessairement l'ID du modèle) dans vos requêtes API.

Surveillance et journalisation

Azure fournit des capacités complètes de surveillance et de journalisation pour votre utilisation de Claude via des modèles Azure standard :

• Azure Monitor : Suivez l'utilisation de l'API, la latence et les taux d'erreur
• Azure Log Analytics : Interrogez et analysez les journaux de requête/réponse
• Cost Management : Surveillez et prévoyez les coûts associés à l'utilisation de Claude

Anthropic recommande de journaliser votre activité sur au moins une base de 30 jours glissants pour comprendre les modèles d'utilisation et enquêter sur les problèmes potentiels.

Dépannage

Erreurs d'authentification

Erreur : 401 Unauthorized ou Invalid API key

• Solution : Vérifiez que votre clé API est correcte. Vous pouvez obtenir une nouvelle clé API à partir du portail Azure sous Clés et point de terminaison pour votre ressource Claude.
• Solution : Si vous utilisez Azure Entra ID, assurez-vous que votre jeton d'accès est valide et n'a pas expiré. Les jetons expirent généralement après 1 heure.

Erreur : 403 Forbidden

• Solution : Votre compte Azure peut manquer des autorisations nécessaires. Assurez-vous que vous avez le rôle Azure RBAC approprié assigné (par exemple, « Cognitive Services OpenAI User »).

Limitation de débit

Erreur : 429 Too Many Requests

• Solution : Vous avez dépassé votre limite de débit. Implémentez une logique de backoff exponentiel et de nouvelle tentative dans votre application.
• Solution : Envisagez de demander des augmentations de limite de débit via le portail Azure ou le support Azure.

En-têtes de limite de débit

Foundry n'inclut pas les en-têtes de limite de débit standard d'Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining et anthropic-ratelimit-output-tokens-reset) dans les réponses. Gérez la limitation de débit via les outils de surveillance d'Azure à la place.

Erreurs de modèle et de déploiement

Erreur : Model not found ou Deployment not found

• Solution : Vérifiez que vous utilisez le nom de déploiement correct. Si vous n'avez pas créé de déploiement personnalisé, utilisez l'ID de modèle par défaut (par exemple, claude-sonnet-4-6).
• Solution : Assurez-vous que le modèle/déploiement est disponible dans votre région Azure.

Erreur : Invalid model parameter

• Solution : Le paramètre model doit contenir le nom de votre déploiement, qui peut être personnalisé dans le portail Foundry. Vérifiez que le déploiement existe et est correctement configuré.

Ressources supplémentaires

• Documentation Foundry : ai.azure.com/catalog
• Tarification Azure : azure.microsoft.com/en-us/pricing
• Détails de tarification Anthropic : Documentation de tarification
• Guide d'authentification : Consultez la section authentification ci-dessus
• Portail Azure : portal.azure.com