Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Önemli
Phi Silika APIs kullanan uygulamalar Sınırlı Erişim Özelliği desteğiyle ilgili sorunlarla karşılaşabilir (bkz. LimitedAccessFeatures).
Şu anda, LAF belirteçleri gerektirmediğinden deneysel sürümleri kullanmanızı öneririz.
Gereksinimler
Donanım
Windows AI APIs API'ye bağlı olarak farklı donanımları destekler. Tam genel bakış için desteklenen donanım tablosuna bakın.
| API | Desteklenen donanım |
|---|---|
| Phi Silis | Copilot+ PC (NPU) veya desteklenen bir GPU’ya sahip bir Windows 11 cihazı (NVIDIA RTX 30 serisi ve sonrası, 6+ GB vRAM; en son sürücüye sahip AMD Radeon) |
| Text Recognition (OCR) | Copilot+ PC (NPU) |
| Konuşma tanıma | Copilot+ PC (NPU) veya önerilen CPU özelliklerini karşılayan bir cihaz |
| Video Süper Çözünürlük | Copilot+ PC (NPU) veya önerilen CPU özelliklerini karşılayan bir cihaz |
| Görüntüleme APIs | Copilot+ PC (NPU) |
NPU hızlandırılmış özellikler için önerilen cihazların listesi için bkz. Copilot+ PCs geliştirici kılavuzu.
Yazılım
Windows 11, sürüm 25H2 (derleme 10.0.26200.7309) veya üstü Copilot+ bilgisayara yüklenmelidir. Bu, Başlat menüsünü açıp "winver" yazıp Enter tuşuna basarak doğrulanabilir (aşağıdakine benzer şekilde işletim sistemi ayrıntılarını içeren bir iletişim kutusu görünmelidir).
Phi Silika özelliklerini kullandığınızdan emin olun:
- Microsoft Store'dan Yapay Zeka Geliştirme Galerisi uygulamasını indirin ve yükleyin.
- Uygulamayı çalıştırma.
- Sol bölmeden AI'yi APIs seçin.
- Phi Silika>Metin Oluşturma'ya tıklayın.
- Phi Silica'nın bir istem yanıtladığını onaylayın (örnek uygulama varsayılan bir istemle başlar).
Diğer öneriler
Geliştiriciler için>Ayarlar>Sistemi>Geliştirici Modu'nda Geliştirici Modu'nu etkinleştirin.
Visual Studio'yu WinUI ve Windows Uygulama SDK'sı ile geliştirmek için gereken iş yükleri ve bileşenlerle yükleyin. Daha fazla ayrıntı için bkz . Gerekli iş yükleri ve bileşenler.
Hata ayıklama
Phi Silica sisteminizde çalışmıyor gibi görünüyorsa, yapabileceğiniz birkaç şey vardır.
Sistemdeki kullanılabilir yapay zeka modellerini gösteren Ayarlar > Sistem > AI Bileşenleri'ne giderek gerekli tüm modellerin yüklü olduğunu doğrulayın. Gerekli model listede yoksa Ayarlar > Windows Update'e gidin ve "Güncelleştirmeleri denetle" seçeneğine tıklayın (yeniden başlatma gerekebilir).
Uygulamanızın geçerli Windows Uygulama SDK'sı en düşük sürümü kullandığını doğrulayın.
- Kararlı kanal: 1.8.0 (1.8.250907003) veya üzeri
- Deneysel kanal (GPU'da Phi Silica için gereklidir): 2.2.2-experimental9 (Haziran 2026 Deneysel) veya sonrası
Windows güncellemelerinin duraklatılmadığından emin olmak için Ayarlar>Güncellemeler'e bakın.
Windows Geri Bildirim Merkezi uygulaması aracılığıyla izlemeleri toplayın ve gözden geçirmek üzere Windows ekibiyle paylaşın.
- Geri Bildirim Merkezi uygulamasını açın (Windows tuşu + F).
- Tercih ettiğiniz hesapla oturum açın.
- 1. bölüme hata ayrıntılarını girin (hata başlığının önüne "[Windows AI APIs]") ekleyin.
- 2. bölümde Sorun'a tıklayın, ilk açılan listeden Geliştirici Platformu'na tıklayın ve ardından ikinci açılan listeden Windows AI Foundry'yi seçin.
- Bölüm 3'de sizinkine benzer tüm geri bildirimler görüntülenir. Mevcut geri bildirim bulunamazsa Yeni geri bildirim'i seçin ve İleri'ye tıklayın.
- Bölüm 4'te şunları yapabilirsiniz:
- Sorunumu yeniden oluştur'a tıklayın, ardından Kaydı başlat'a tıklayın, AI Geliştirme Galerisi'ni çalıştırın, sorunu yeniden oluşturun, kaydı durdurun.
- Ek bilgileri ve ekleri (resimler gibi) ekleyin. Çoğaltma adımları ve hata iletileri de dahil olmak üzere mümkün olduğunca çok ayrıntı sağlayın.
- Geri bildirimi gönderin.
GPU sorunlarını giderme (Phi Silica)
GPU'da Phi Silika, Geliştirici Modunun etkinleştirilmesini gerektirir (Geliştiriciler> için Ayarlar>Sistemi>Geliştirici Modu).
GPU'da Phi Silica çalıştırmak için en son sürücünün doğrudan GPU üreticisinden (NVIDIA GeForce 615.21 beta, AMD Software: Adrenalin Edition 26.10.2) yüklenmesi gerekir. Windows Update veya OEM yüklemelerindeki varsayılan sürücüler yeterli olmayabilir. OEM sürücülerinin veya Windows Update önceden yüklenmiş GPU sürücülerinin üzerine yazabileceğini unutmayın; Phi Silica bir güncelleştirmeden sonra çalışmayı durdurursa, en son sürücüyü doğrudan GPU üreticisinden yeniden yükleyin.
Phi Silika GPU desteği için NVIDIA GPU'ları (RTX 30 serisi ve 6+ GB vRAM ile daha yeni sürümler) veya en son sürücüye sahip AMD Radeon GPU'ları gerekir. GPU cihazında başarısız olursa EnsureReadyAsync , GPU sürücü sürümünüzün en düşük gereksinimleri karşıladığını doğrulayın.
CPU sorunlarını giderme (Video Süper Çözünürlük, Konuşma Tanıma)
Bu özellikler herhangi bir CPU üzerinde çalışır ancak önerilen özellikleri karşılayan cihazlarda en iyi performansı gösterir: en az 4 fiziksel çekirdek, 3 GHz veya daha yüksek bir temel saat ve 32 MB veya daha fazla L3 önbelleği. Yavaş performans, takılmalar veya kalitede düşüş fark ederseniz, ana bilgisayar CPU’sunu bu önerilerle karşılaştırın. Cihaz önerilen özellikleri karşıladığında true döndüren bir çalışma zamanı denetimi için MeetsRecommendedCpuSpecs Video Super Resolution belgelerindeki C# örneğine bakın.
VSR modeli Windows Uygulama SDK'sı ile birlikte gelir ve ayrı olarak indirilemez; VSR başlatılamazsa, model durumu yerine desteklenen çözümleme ve biçimlendirme kısıtlamaları için VSR belgelerini denetleyin.
Diğer yönergeler
Kullanan Windows AI APIs uygulamalara çalışma zamanında paket kimliği verilmesi gerekir. Ayrıntılar için bkz. Uygulamanızı paketlemenin avantajları ve dezavantajları. UnauthorizedAccessException hatası görüyorsanız (veya başka erişim sorunlarıyla karşılaşıyorsanız), uygulamanızın paketlendiğinden ve systemAIModels özelliğinin bildirim dosyanıza eklendiğinden emin olun (bkz. ile Windows AI APIsuygulama oluşturmaya başlama).
Sınırlı Erişim Özelliği (LAF) gereksinimleri:
- Microsoft'tan bir LAF belirteci istediğinizi ve aldığınızı doğrulayın
- Aşağıdaki durum değerleri LAF'ın başarısız olduğunu gösterir.
Bağımsız uygulamalar İndirilenler klasöründen (veya klasörün altındaki
C:\Usersherhangi bir yerden) çalıştırılamaz. Daha fazla ayrıntı için bkz. Uygulamanızı paketlemenin avantajları ve dezavantajları ve Windows Uygulama SDK'sı dağıtımına genel bakış.Windows Uygulama SDK'sı deneysel kanalı, geliştirme aşamasındaki özellikler ile APIs içerir. Deneysel kanaldaki tüm APIs öğeler kapsamlı düzeltmelere ve önemli değişikliklere tabidir ve herhangi bir zamanda sonraki sürümlerden kaldırılabilir. Deneysel özellikler üretim ortamlarında kullanılmak üzere desteklenmez ve bunları kullanan uygulamalar Microsoft Store'da yayımlanamaz.
Windows Uygulama SDK'sı GitHub deposunda APIs oluşturarak (başlığa Phi Silika'nın eklenmesi) veya mevcut bir soruna yanıt vererek bunlar ve işlevleri hakkında geri bildirim sağlayın.