Solución de problemas de la API de Windows AI

Requisitos

Equipamiento

Windows AI APIs admiten hardware diferente en función de la API. Consulte la tabla de hardware compatible para obtener información general completa.

Para consultar las funciones aceleradas por la NPU, consulte la guía para desarrolladores de Copilot+ PCs para obtener una lista de dispositivos recomendados.

Programas informáticos

Windows 11, versión 25H2 (compilación 10.0.26200.7309) o posterior debe instalarse en el equipo Copilot+. Para comprobarlo, abra el menú Inicio, escriba "winver" y presione Entrar (un cuadro de diálogo con los detalles del sistema operativo, similar al siguiente, debería aparecer).

Asegúrese de que puede usar características de PhiLice:

1. Descargue e instale la aplicación ai Dev Gallery desde Microsoft Store.
2. Ejecute la aplicación.
3. Seleccione IA APIs en el panel izquierdo.
4. Haga clic en Phi Silica>Text Generation.
5. Confirme que PhiLice responde a un aviso (la aplicación de ejemplo comienza con un mensaje predeterminado).

Otras recomendaciones

Habilite Modo desarrollador en Configuración>Sistema>Para desarrolladores>Modo desarrollador.

Instale Visual Studio con las cargas de trabajo y los componentes necesarios para desarrollar con WinUI y SDK de Aplicaciones para Windows. Para más información, consulte Cargas de trabajo y componentes necesarios.

Depuración

Si PhiLice no parece estar trabajando en su sistema, hay algunas cosas que puede hacer.

1. Compruebe que tiene todos los modelos necesarios instalados; para ello, vaya a Configuración componentes > de IA del sistema>, que muestra los modelos de IA disponibles en el sistema. Si el modelo necesario no aparece en la lista, vaya a Configuración > de Windows Update y haga clic en "Buscar actualizaciones" (es posible que se requiera un reinicio).

2. Compruebe que la aplicación usa una versión mínima de SDK de Aplicaciones para Windows válida.

   • Canal estable: 1.8.0 (1.8.250907003) o posterior
   • Canal experimental (necesario para Phi Silica en GPU): 2.2.2-experimental9 (June 2026 Experimental) o una versión posterior

3. Compruebe Actualizaciones de configuración>para asegurarse de que las actualizaciones de Windows no están en pausa.

4. Recopile registros a través de la aplicación Centro de comentarios de Windows y compártalos con el equipo de Windows para revisarlos.

   1. Abra la aplicación Centro de opiniones (clave de Windows + F).
   2. Inicie sesión con su cuenta preferida.
   3. Escriba los detalles del error en la sección 1 (prefijo del título del error con "[Windows AI APIs]").
   4. En la sección 2, haga clic en Problema, seleccione Plataforma para desarrolladores en la primera lista desplegable y, a continuación, seleccione Windows AI Foundry en la segunda lista desplegable.
   5. La sección 3 mostrará los comentarios existentes similares a los suyos. Si no se encuentra ningún comentario existente, seleccione Nuevo comentario y haga clic en Siguiente.
   6. En la sección 4 puede:
      1. Haga clic en Volver a crear mi problema y, a continuación, haga clic en Iniciar grabación, ejecute ai Dev Gallery, reproduzca el problema y detenga la grabación.
      2. Incluya información adicional y datos adjuntos (como imágenes). Proporcione tantos detalles como sea posible, incluidos los pasos de reproducción y los mensajes de error.
   7. Envíe los comentarios.

Solución de problemas de GPU (PhiLice)

Phi Silica en la GPU requiere que Modo de desarrollador esté habilitado (Configuración>Sistema>Para desarrolladores>Modo de desarrollador).

La ejecución de PhiLice en GPU requiere el controlador más reciente instalado directamente desde el fabricante de GPU (NVIDIA GeForce 615.21 beta, AMD Software: Adrenalin Edition 26.10.2). Es posible que los controladores predeterminados de las instalaciones de Windows Update o OEM no sean suficientes. Tenga en cuenta que los controladores OEM o Windows Update pueden sobrescribir los controladores de GPU instalados anteriormente, si PhiLice deja de funcionar después de una actualización, vuelva a instalar el controlador más reciente directamente desde el fabricante de GPU.

La compatibilidad con GPU de Phi Silica requiere GPU de NVIDIA (serie RTX 30 y posteriores con 6 GB o más de VRAM) o bien GPU Radeon de AMD con el controlador más reciente. Si EnsureReadyAsync se produce un error en un dispositivo gpu, compruebe que la versión del controlador de GPU cumple los requisitos mínimos.

Solución de problemas de CPU (super resolución de vídeo, reconocimiento de voz)

Estas características se ejecutan en cualquier CPU pero funcionan mejor en los dispositivos que cumplen las especificaciones recomendadas: al menos 4 núcleos físicos, un reloj base de 3 GHz o superior, y 32 MB o más de caché L3. Si ve un rendimiento lento, un estutete o una calidad reducida, compruebe la CPU del host con estas recomendaciones. Para una comprobación en tiempo de ejecución que devuelva true cuando el dispositivo cumpla las especificaciones recomendadas, consulte el MeetsRecommendedCpuSpecs ejemplo de C# en la documentación de Superresolución de vídeo.

El modelo de VSR se distribuye con el SDK de Aplicaciones para Windows y no se puede descargar por separado; si VSR no se puede inicializar, compruebe la documentación de VSR para las restricciones de formato y resolución admitidas en lugar de estado del modelo.

Otras instrucciones

• Las aplicaciones que usan Windows AI APIs deben concederse identidades de paquete en tiempo de ejecución. Para obtener más información, consulta Ventajas y desventajas del empaquetado de la aplicación. Si ve un error UnauthorizedAccessException (o tiene otros problemas de acceso), asegúrese de que la aplicación está empaquetada y de que la funcionalidad systemAIModels se agregó al archivo de manifiesto (consulte Introducción a la creación de una aplicación con Windows AI APIs).

• Requisitos de la Funcionalidad de Acceso Limitado (LAF):

  • Compruebe que ha solicitado y recibido un token laF de Microsoft.
  • Los siguientes valores de estado indican que LAF ha fallado.
    • LimitedAccessFeatureStatus.Unavailable
    • EstadoFunciónAccesoLimitado.Desconocido

• Las aplicaciones independientes no se pueden ejecutar desde la carpeta Descargas (o desde cualquier lugar de la C:\Users carpeta). Para obtener más información, consulte Ventajas y desventajas del empaquetado de la aplicación y la introducción a la implementación de SDK de Aplicaciones para Windows.

• El canal experimental del SDK de aplicaciones de Windows incluye APIs y características en etapas tempranas de desarrollo. Todo APIs en el canal experimental está sujeto a revisiones extensas y cambios importantes y se puede quitar de las versiones posteriores en cualquier momento. Las características experimentales no se admiten para su uso en entornos de producción y las aplicaciones que las usan no se pueden publicar en Microsoft Store.

• Proporcione comentarios sobre estas APIs y su funcionalidad creando un nuevo problema en el repositorio de GitHub del SDK de aplicaciones de Windows (incluya PhiLice en el título) o respondiendo a un problema existente.

Consulte también

• Galería de desarrollo de IA
• Ejemplos de la API de Windows AI