Claude dans Microsoft Foundry

Ce guide vous accompagne dans le processus de configuration et d'envoi d'appels API à Claude dans Foundry en utilisant l'un des SDK clients d'Anthropic ou des requêtes HTTP directes. Lorsque vous accédez à Claude dans Foundry, votre utilisation de Claude est facturée via le Microsoft Marketplace, 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. La tarification de Claude dans le Microsoft Marketplace utilise la tarification API standard d'Anthropic. Consultez la page Tarification pour plus de détails.



Préversion

Dans cette intégration de plateforme en préversion, 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 sous-traitant 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 de pointe en matière de sécurité et de données, y compris la disponibilité de la rétention zéro des données.



Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un abonnement Azure actif
• Un 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 un package ou une classe client spécifique à la plateforme.



Provisionnement

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 créerez d'abord une ressource Foundry, puis un ou plusieurs déploiements Claude au sein de celle-ci.



Provisionnement des ressources Foundry

Créez une ressource Foundry, qui est nécessaire 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 la création d'une ressource Foundry.

Pour provisionner 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 (anciennement Azure Active Directory) 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é (Azure Virtual Network) pour une sécurité renforcée
5. Notez le nom de votre ressource. Vous l'utiliserez comme {resource} dans les points de terminaison de l'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. Accédez à Models + endpoints et sélectionnez + Deploy model > Deploy base model
3. Recherchez et sélectionnez un modèle Claude (par exemple, claude-sonnet-4-6)
4. Configurez les paramètres de déploiement :
   • Deployment name : par défaut, il s'agit de l'ID 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.
   • Deployment type : sélectionnez Global Standard (recommandé pour Claude)
5. Sélectionnez Deploy et attendez la fin du provisionnement
6. Une fois le déploiement effectué, vous pouvez trouver l'URL de votre point de terminaison et vos clés sous Keys and Endpoint



Authentification

Claude dans 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 provisionné votre ressource Claude dans Foundry, vous pouvez obtenir une clé API depuis le portail Foundry :

1. Accédez à votre ressource dans le portail Foundry
2. Accédez à la section Keys and Endpoint
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-la au SDK

Les SDK Foundry nécessitent une clé API et soit un nom de ressource, soit une URL de base. Les SDK C#, Java, PHP, Python et TypeScript lisent automatiquement ces valeurs à partir des variables d'environnement suivantes si elles sont définies :

• 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 des jetons Entra ID :

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

Exemple utilisant Entra ID :



Identifiants de corrélation des requêtes

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



Prise en charge des fonctionnalités

Claude dans 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 Vue d'ensemble des fonctionnalités.



Fenêtre de contexte

Claude Fable 5, Claude Opus 4.7, Claude Opus 4.6 et Claude Sonnet 4.6 disposent d'une fenêtre de contexte de 1 million de tokens sur Microsoft Foundry. Les autres modèles Claude, y compris Claude Opus 4.8 et Sonnet 4.5, disposent d'une fenêtre de contexte de 200 000 tokens.



Fonctionnalités non prises en charge

• Admin API
• Compliance API
• Models API
• Message Batches API
• Repli côté serveur (le paramètre fallbacks ; utilisez plutôt le modèle de repli côté client)



Réponses de l'API

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

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



ID de modèles API et déploiements

Les termes du cycle de vie (Déprécié, Retiré) sont définis dans Dépréciations de modèles. Microsoft Foundry suit le calendrier du cycle de vie de l'API Claude.

Les modèles Claude suivants sont disponibles via Foundry. Les modèles de dernière génération (Claude Fable 5, Opus 4.8, 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èles indiqués dans le tableau précédent. 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 les 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êtes/réponses
• Cost Management : surveillez et prévoyez les coûts associés à l'utilisation de Claude

Anthropic recommande de journaliser votre activité sur une base glissante d'au moins 30 jours afin de comprendre les modèles d'utilisation et d'enquêter sur tout problème potentiel.



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 depuis le portail Foundry sous Keys and Endpoint pour votre ressource Foundry.
• Solution : si vous utilisez Microsoft 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 ne dispose peut-être pas des autorisations nécessaires. Assurez-vous que le rôle Azure RBAC approprié vous est attribué (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 plutôt la limitation de débit via les outils de surveillance d'Azure.



Erreurs de modèle et de déploiement

Erreur : Model not found ou Deployment not found

• Solution : vérifiez que vous utilisez le bon nom de déploiement. 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 votre nom de 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/details/ai-foundry
• Détails de la tarification Anthropic : Tarification des modèles
• Guide d'authentification : consultez Authentification
• Portail Azure : portal.azure.com