Résolution des problèmes liés à l’API Windows AI

Importante

Les applications utilisant Phi Silicon APIs peuvent rencontrer des problèmes avec la prise en charge des fonctionnalités d’accès limité (voir LimitedAccessFeatures).

À ce stade, nous vous recommandons d’utiliser des versions expérimentales , car elles ne nécessitent pas de jetons LAF.

Spécifications

Matériel

Windows AI APIs prend en charge différents matériels en fonction de l’API. Consultez la table matérielle prise en charge pour obtenir une vue d’ensemble complète.

API Matériel pris en charge
Phi Silicon Copilot+ PC (NPU) ou un appareil Windows 11 avec un GPU pris en charge (série NVIDIA RTX 30 et versions ultérieures avec 6 Go de mémoire virtuelle ; Prise en charge du GPU AMD bientôt disponible)
Text Recognition (OCR) Copilot+ PC (NPU)
Reconnaissance vocale Copilot+ PC (NPU) ou un appareil répondant aux spécifications de processeur recommandées
Super-résolution vidéo Copilot+ PC (NPU) ou un appareil répondant aux spécifications de processeur recommandées
Imagerie APIs Copilot+ PC (NPU)

Pour connaître les fonctionnalités accélérées par NPU, consultez Copilot+ PCs guide du développeur pour obtenir la liste des appareils recommandés.

Logiciel

Windows 11, version 25H2 (build 10.0.26200.7309) ou version ultérieure doit être installé sur le PC Copilot+. Cela peut être vérifié en ouvrant le menu Démarrer, en tapant « winver » et en appuyant sur Entrée (une boîte de dialogue contenant les détails du système d’exploitation, semblable à ce qui suit, doit apparaître).

Capture d’écran de la boîte de dialogue Version de Windows affichée en tapant « winver », puis en appuyant sur Entrée.

Assurez-vous que vous pouvez utiliser les fonctionnalités de Phi Silicon :

  1. Téléchargez et installez l’application ai Dev Gallery à partir du Microsoft Store.
  2. Exécutez l’application.
  3. Sélectionnez l’IA APIs dans le volet gauche.
  4. Cliquez sur Phi Silicon>Text Generation.
  5. Vérifiez que Phi Silicon répond à une invite (l’exemple d’application commence par une invite par défaut).

Capture d’écran de l’exemple d’application ai Dev Gallery montrant un exemple de base de la fonctionnalité Génération de texte.

Autres recommandations

Activez le mode développeur dans lesystème>paramètres>pour les développeurs>en mode développeur.

Installez Visual Studio avec les charges de travail et les composants requis pour le développement avec WinUI et le Kit de développement logiciel (SDK) d’application Windows. Pour plus d’informations, consultez Charges de travail et composants obligatoires.

Débogage

Si Phi Silicon ne semble pas travailler sur votre système, il y a quelques choses que vous pouvez faire.

  1. Vérifiez que tous les modèles requis sont installés en accédant aux composants IA du système > de paramètres>, qui affichent les modèles IA disponibles sur le système. Si le modèle requis n’est pas répertorié, accédez à Paramètres > Windows Update et cliquez sur « Rechercher les mises à jour » (un redémarrage peut être nécessaire).

  2. Vérifiez que votre application utilise une version SDK d'application Windows minimale valide.

    • Canal stable : 1.8.0 (1.8.250907003) ou version ultérieure
    • Canal expérimental (requis pour Phi Silicon sur GPU) : 2.2.2-experimental9 (juin 2026 Expérimental) ou version ultérieure

  3. Vérifiez lesmises à jour> pour vous assurer que les mises à jour Windows ne sont pas suspendues.

  4. Collectez les traces via l'application Hub de commentaires Windows et partagez-les pour révision par l'équipe Windows.

    1. Ouvrez l’application Hub de commentaires (touche Windows + F).
    2. Connectez-vous avec votre compte préféré.
    3. Entrez les détails du bogue dans la section 1 (préfixez le titre du bogue avec « [Windows AI APIs] »).
    4. Dans la section 2, cliquez sur Problème, sélectionnez Plateforme de développement dans la première liste déroulante, puis Sélectionnez Windows AI Foundry dans la deuxième liste déroulante.
    5. La section 3 affiche tous les commentaires existants similaires à ceux dont vous avez fait l’objet. Si aucun commentaire existant n’est trouvé, sélectionnez Nouveau commentaire , puis cliquez sur Suivant.
    6. Dans la section 4, vous pouvez :
      1. Cliquez sur Recréer mon problème, puis cliquez sur Démarrer l’enregistrement, exécutez ai Dev Gallery, reproduisez le problème, arrêtez l’enregistrement.
      2. Incluez des informations et des pièces jointes supplémentaires (telles que des images). Fournissez autant de détails que possible, y compris les étapes de reproduction et les messages d’erreur.
    7. Envoyez les commentaires.

Résolution des problèmes gpu (Phi Silicon)

Phi Silicon sur GPU nécessite que le mode développeur soit activé (Système>de paramètres>pour les développeurs>en mode développeur).

L’exécution de Phi Silicon sur GPU nécessite que le pilote le plus récent soit installé directement à partir du fabricant du GPU (NVIDIA GeForce 615.21 bêta). La prise en charge du GPU AMD est bientôt disponible. Les pilotes par défaut de Windows Update ou d’installations OEM peuvent ne pas suffire. Notez que les pilotes OEM ou les Windows Update peuvent remplacer les pilotes GPU précédemment installés : si Phi Silicon cesse de fonctionner après une mise à jour, réinstallez le dernier pilote directement à partir du fabricant du GPU.

La prise en charge du GPU Phi Silicon nécessite actuellement des GPU NVIDIA (série RTX 30 et versions ultérieures avec une vRAM de 6 Go). La prise en charge du GPU AMD est bientôt disponible. Si EnsureReadyAsync échoue sur un GPU, vérifiez que la version de votre pilote graphique respecte les exigences minimales.

Résolution des problèmes d’UC (vidéo super résolution, reconnaissance vocale)

Ces fonctionnalités s’exécutent sur n’importe quel processeur, mais fonctionnent le mieux sur les appareils qui répondent aux spécifications recommandées : au moins 4 cœurs physiques, une horloge de base de 3 GHz ou supérieure, et 32 Mo ou plus du cache L3. Si vous voyez des performances lentes, des stutters ou une qualité réduite, vérifiez l’UC de l’hôte par rapport à ces recommandations. Pour une vérification à l’exécution qui renvoie true lorsque l’appareil respecte la configuration recommandée, consultez MeetsRecommendedCpuSpecs l’exemple C# dans la documentation sur Video Super Resolution.

Le modèle VSR est fourni avec le SDK d'application Windows et n’est pas téléchargeable séparément ; si VSR ne parvient pas à initialiser, vérifiez la documentation VSR pour les contraintes de résolution et de format prises en charge plutôt que pour l’état du modèle.

Autres conseils

Voir aussi

  • Last updated on