重要
Phi Silica APIs を使用するアプリでは、制限付きアクセス機能のサポートに関する問題が発生する可能性があります ( LimitedAccessFeatures を参照)。
現時点では、LAF トークンを必要としないため、 試験段階のリリース を使用することをお勧めします。
Requirements
ハードウェア
Windows AI APIsは、API に応じて異なるハードウェアをサポートします。 完全な概要については、 サポートされているハードウェアの表 を参照してください。
| API | サポートされているハードウェア |
|---|---|
| Phi Silica | Copilot+ PC (NPU) またはサポートされている GPU を備えたWindows 11 デバイス (NVIDIA RTX 30 シリーズ以降、6 GB 以上の vRAM あり)。最新のドライバーを搭載した AMD Radeon) |
| Text Recognition (OCR) | Copilot+ PC (NPU) |
| 音声認識 | Copilot+ PC (NPU) または推奨される CPU 仕様を満たすデバイス |
| ビデオのスーパー解像度 | Copilot+ PC (NPU) または推奨される CPU 仕様を満たすデバイス |
| イメージング APIs | Copilot+ PC (NPU) |
NPU アクセラレータ機能については、推奨されるデバイスの一覧については、Copilot+ PCs 開発者ガイドを参照してください。
ソフトウェア
Windows 11 バージョン 25H2 (ビルド 10.0.26200.7309) 以降を Copilot+ PC にインストールする必要があります。 これを確認するには、[スタート] メニューを開き、「winver」と入力し、Enter キーを押します (次のような OS の詳細が表示されたダイアログ ボックスが表示されます)。
Phi Silica の機能を使用できることを確認します。
- Microsoft Store から AI Dev Gallery アプリをダウンロードしてインストールします。
- アプリを実行します。
- 左側のウィンドウから [AI APIs ] を選択します。
- [Phi Silica>Text Generation] をクリックします。
- Phi Silica がプロンプトに応答することを確認します (サンプル アプリは既定のプロンプトで開始されます)。
その他の推奨事項
Settings>>> で開発者モードを有効にします。
WinUI と Windows アプリ SDK を使用した開発に必要なワークロードとコンポーネントを含む Visual Studio をインストールします。 詳細については、「 必要なワークロードとコンポーネント」を参照してください。
デバッグ
Phi Silica がシステムで動作していないように見える場合は、いくつかのことができます。
[システム > AI コンポーネントの設定] >移動して、必要なすべてのモデルがインストールされていることを確認します。このコンポーネントには、システムで使用可能な AI モデルが表示されます。 必要なモデルが一覧にない場合は、[ Windows Update > 設定] に移動し、[更新プログラムの確認] をクリックします (再起動が必要な場合があります)。
アプリが有効なWindows アプリ SDK最小バージョンを使用していることを確認します。
- 安定チャネル: 1.8.0 (1.8.250907003) 以降
- 実験チャネル (GPU 上の Phi Silica に必要): 2.2.2-experimental9 (2026 年 6 月試験) 以降
[設定]>[更新]をオンにして、Windows の更新プログラムが一時停止されていないことを確認します。
Windows フィードバック ハブ アプリを使用してトレースを収集し、Windows チームと共有して確認します。
- フィードバック ハブ アプリを開きます (Windows キー + F キー)。
- お好みのアカウントでサインインします。
- セクション 1 にバグの詳細を入力します (バグ タイトルの前に "[Windows AI APIs]" を付けます)。
- セクション 2 で、[ 問題] をクリックし、最初のドロップダウンから [開発者プラットフォーム ] を選択し、2 番目のドロップダウンから [Windows AI Foundry ] を選択します。
- セクション 3 には、お客様に似た既存のフィードバックが表示されます。 既存のフィードバックが見つからない場合は、[ 新しいフィードバック ] を選択し、[ 次へ] をクリックします。
- セクション 4 では、次のことができます。
- [ 問題の再作成]、[ 記録の開始]、[AI 開発ギャラリーの実行]、[問題の再現]、[記録の停止] の順にクリックします。
- 追加情報と添付ファイル (画像など) を含めます。 再生手順やエラー メッセージなど、可能な限り詳細を指定します。
- フィードバックを送信します。
GPU のトラブルシューティング (Phi Silica)
GPU 上の Phi Silica では、 開発者モード (Settings>System>For developers>Developer Mode) が有効になっている必要があります。
GPU で Phi Silica を実行するには、GPU 製造元 (NVIDIA GeForce 615.21 ベータ版、AMD ソフトウェア: アドレナリン エディション 26.10.2) から直接インストールされた最新のドライバーが必要です。 Windows Updateまたは OEM インストールの既定のドライバーでは不十分な場合があります。 OEM ドライバーまたはWindows Updateによって、以前にインストールされた GPU ドライバーが上書きされる可能性があることに注意してください。更新後に Phi Silica が動作を停止した場合は、GPU 製造元から最新のドライバーを直接再インストールします。
Phi Silica GPU のサポートには、最新のドライバーを搭載した NVIDIA GPU (6 GB 以上の vRAM を搭載した RTX 30 シリーズ以降) または AMD Radeon GPU が必要です。 GPU デバイスで EnsureReadyAsync が失敗した場合は、GPU ドライバーのバージョンが最小要件を満たしていることを確認します。
CPU のトラブルシューティング (ビデオのスーパー解像度、音声認識)
これらの機能は任意の CPU で実行されますが、 推奨される仕様を満たすデバイス (少なくとも 4 つの物理コア、3 GHz 以上のベース クロック、32 MB 以上の L3 キャッシュ) で最適に動作します。 パフォーマンスの低下、吃音、または品質の低下が見られた場合は、これらの推奨事項に照らしてホスト CPU を確認します。 デバイスが推奨仕様を満たしたときにtrueを返すランタイム チェックについては、ビデオスーパー解像度のドキュメントの MeetsRecommendedCpuSpecs C# サンプルを参照してください。
VSR モデルにはWindows アプリ SDKが付属しており、個別にダウンロードできません。VSR の初期化に失敗した場合は、モデルの状態ではなく、サポートされている解決と形式の制約についてVSR のドキュメントを確認してください。
その他のガイダンス
Windows AI APIsを使用するアプリには、実行時にパッケージ ID を付与する必要があります。 詳細については、 アプリのパッケージ化の長所と短所に関するページを参照してください。 UnauthorizedAccessException エラー (またはその他のアクセスの問題) が発生している場合は、アプリがパッケージ化され、systemAIModels 機能がマニフェスト ファイルに追加されていることを確認します (「Windows AI APIsを使用したアプリのビルドの開始」を参照してください)。
制限付きアクセス機能 (LAF) の要件:
- Microsoft から LAF トークンを要求して受け取ったことを確認します
- 次の状態値は、LAF が失敗したことを示しています。
自己完結型アプリは 、ダウンロード フォルダーから (または
C:\Usersフォルダーの下の任意の場所から) 実行できません。 詳細については、アプリと Windows アプリ SDK のデプロイの概要をパッケージ化する利点と欠点に関するページを参照してください。Windows アプリ SDK の実験用チャネルには、開発の初期段階で APIs と機能が含まれています。 実験用チャネルのすべての APIs は、広範な変更と破壊的変更の対象となり、今後のリリースからいつでも削除される可能性があります。 試験段階の機能は運用環境での使用はサポートされておらず、使用するアプリは Microsoft Store に公開できません。
Windows アプリ SDK GitHub リポジトリにAPIs (タイトルに Phi Silica を含む) を作成するか、既存の問題に対応することで、これらのとその機能に関するフィードバックを提供します。