---
read_when:
    - Vous installez, configurez ou auditez le plugin microsoft-foundry
summary: Ajoute la prise en charge du fournisseur de modèles Microsoft Foundry à OpenClaw.
title: Plugin Microsoft Foundry
x-i18n:
    generated_at: "2026-07-16T13:36:04Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: f2ea554ce16cffeb4cc315e53d986d6f07b5e113fbb844c61c6575f19f8ad291
    source_path: plugins/reference/microsoft-foundry.md
    workflow: 16
---

# Plugin Microsoft Foundry

Ajoute la prise en charge du fournisseur de modèles Microsoft Foundry à OpenClaw.

## Distribution

- Paquet : `@openclaw/microsoft-foundry`
- Voie d’installation : inclus dans OpenClaw

## Surface

fournisseurs : `microsoft-foundry`; contrats : `imageGenerationProviders`

<!-- openclaw-plugin-reference:manual-start -->

- Fournisseur de génération d’images : `microsoft-foundry`

## Prérequis

- Une ressource Microsoft Foundry ou Azure AI Foundry comportant des déploiements.
- Authentification par clé API via `AZURE_OPENAI_API_KEY` ou une clé API de fournisseur configurée.
- Pour l’authentification Entra ID, installez la CLI Azure et exécutez `az login` avant
  l’intégration. OpenClaw actualise les jetons d’exécution Microsoft Foundry via
  `az account get-access-token`.

## Modèles de chat

Les déploiements de chat Microsoft Foundry utilisent la référence de modèle du fournisseur
`microsoft-foundry/<deployment-name>`. L’intégration détecte les ressources
et les déploiements Foundry à l’aide de la CLI Azure, puis inscrit le nom du déploiement sélectionné dans
la configuration du modèle.

OpenClaw utilise le point de terminaison Foundry `/openai/v1` pour les API de chat compatibles
avec OpenAI prises en charge :

- Les familles de modèles GPT, `o*`, `computer-use-preview` et DeepSeek-V4 utilisent par défaut
  `openai-responses`.
- MAI-DS-R1 et les autres déploiements de complétion de chat utilisent `openai-completions`,
  sauf si une API prise en charge est explicitement configurée.
- MAI-DS-R1 est enregistré comme capable de raisonnement grâce au contenu de raisonnement, et non
  via `reasoning_effort`. Les métadonnées relatives à son contexte et à ses jetons de sortie sont de
  163,840 jetons.

Les déploiements Anthropic Claude dans Microsoft Foundry utilisent le format de l’API Anthropic Messages,
et non le format compatible avec OpenAI `/openai/v1`. Configurez-les en tant que
fournisseur `anthropic-messages` personnalisé jusqu’à ce que le Plugin Microsoft Foundry dispose d’un
environnement d’exécution Anthropic natif. Lorsque le nom du déploiement Foundry diffère de
l’identifiant du modèle Claude, définissez `params.canonicalModelId` dans l’entrée du modèle afin qu’OpenClaw
puisse appliquer les contrats de transmission propres au modèle, mapper correctement `/think off` et
préserver de manière sûre la réflexion signée.

## Génération d’images MAI

Le Plugin enregistre `microsoft-foundry` pour `image_generate` avec les modèles
d’images Microsoft AI actuels :

- `MAI-Image-2.5-Flash`
- `MAI-Image-2.5`
- `MAI-Image-2e`
- `MAI-Image-2`

Utilisez le nom d’un déploiement d’images MAI déployé comme référence de modèle. Le fournisseur ne
déclare aucun modèle d’image par défaut, car l’API MAI exige le nom de votre déploiement
dans le champ `model` de la requête :

```json5
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "microsoft-foundry/<deployment-name>",
        timeoutMs: 600000,
      },
    },
  },
}
```

La génération à partir d’une invite seule appelle le point de terminaison de génération MAI de Microsoft Foundry :
`/mai/v1/images/generations`. Les modifications à partir d’une image de référence appellent
`/mai/v1/images/edits` et sont limitées aux déploiements `MAI-Image-2.5-Flash` et
`MAI-Image-2.5`.

La génération à partir d’une invite seule peut utiliser un nom de déploiement personnalisé avec uniquement le point de terminaison
Foundry configuré. Pour les modifications d’images avec un nom de déploiement personnalisé, sélectionnez le
déploiement lors de l’intégration ou incluez les métadonnées du modèle afin qu’OpenClaw puisse vérifier
que le déploiement repose sur `MAI-Image-2.5-Flash` ou `MAI-Image-2.5`.

Contraintes des images MAI :

- Sortie : une image PNG par requête.
- Taille : `1024x1024` par défaut ; la largeur et la hauteur doivent toutes deux être d’au moins 768 px.
- Nombre total de pixels : largeur × hauteur ne doit pas dépasser 1,048,576.
- Modifications : une image d’entrée PNG ou JPEG.
- Les indications partagées non prises en charge telles que `aspectRatio`, `resolution`, `quality`,
  `background` et les formats `outputFormat` autres que PNG ne sont pas envoyées à Microsoft Foundry.

## Dépannage

- `az: command not found` : installez la CLI Azure ou utilisez l’authentification par clé API.
- `Microsoft Foundry endpoint missing for MAI image generation` : sélectionnez un
  déploiement Foundry lors de l’intégration ou ajoutez `models.providers.microsoft-foundry.baseUrl`.
- `supports MAI image deployments only` : le modèle d’image sélectionné pointe vers un
  déploiement non-MAI. Utilisez un modèle d’image MAI déployé pour `image_generate`.

<!-- openclaw-plugin-reference:manual-end -->