Inicio rápido: Uso de la API

Importante

Debido al anuncio de retirada de Azure Media Services, Video Indexer de Azure AI anuncia los ajustes de las características de Video Indexer de Azure AI. Consulte Cambios relacionados con la retirada de Azure Media Service (AMS) para comprender lo que esto significa para la cuenta de Video Indexer de Azure AI. Consulte la guía Preparación para la retirada de AMS: vi actualización y migración.

Video Indexer de Azure AI consolida varias tecnologías de inteligencia artificial (IA) de audio y vídeo ofrecidas por Microsoft en un servicio integrado que facilita el desarrollo. Video Indexer de Azure AI está diseñado para permitir a los desarrolladores centrarse en el uso de tecnologías de inteligencia artificial multimedia sin preocuparse por la escala, el alcance global, la disponibilidad y la confiabilidad de las plataformas en la nube. Puede usar la API para cargar los archivos, obtener información detallada del vídeo, obtener direcciones URL de información insertable, widgets de reproductor y mucho más.

Cuando visita el sitio web de Video Indexer de Azure AI por primera vez, se crea automáticamente una cuenta de prueba. Con la cuenta de prueba, obtendrá algunos minutos de indexación gratis. Más adelante puede agregar una cuenta de pago. Con la opción de pago, paga por minutos indizado. Para más información sobre las cuentas disponibles (opciones de prueba y de pago), vea Tipos de cuenta de Video Indexer de Azure AI.

En este artículo se muestra cómo usar La API de Video Indexer de Azure AI.

Requisitos previos

Cargue un archivo multimedia. Existen dos formas:

1. Cargue un archivo multimedia en la dirección URL que prefiera (recomendado). Puede usar una ubicación de red pública. Después de cargar el archivo, puede comprobar si el archivo es accesible para AVI copiando y pegandolo en la barra de ubicación del explorador. Si puede reproducir el archivo multimedia, es probable que VI también pueda acceder a él. Si desea proteger la ubicación de almacenamiento mediante Azure Storage Blob, cargue el archivo y obtenga una dirección URL de SAS. Para más información sobre cómo obtener una dirección URL segura para el archivo, consulte Direcciones URL de SAS de Azure Blob Storage. Esta dirección URL se usa para copiar el archivo en Video Indexer de Azure AI para la indexación.

2. Envíe el archivo de vídeo a una matriz de bytes en el cuerpo de la solicitud. Para obtener más información sobre cómo cargar un archivo multimedia como una matriz de bytes en un cuerpo de solicitud, consulte Carga de un blob con .NET.

Nota:

Hay un límite de solicitudes de API de 10 solicitudes por segundo hasta un máximo de 120 solicitudes por minuto.

Suscripción a la API

Importante

• Debe usar el mismo correo electrónico que usó al registrarse en Video Indexer de Azure AI.
• Las cuentas personales de Google y Microsoft (Outlook/Live) solo se pueden usar para las cuentas de evaluación gratuita. Las cuentas conectadas a Azure requieren id. de Entra.
• Solo puede haber una cuenta activa por correo electrónico. Si un usuario intenta iniciar sesión con user@gmail.com para LinkedIn y después con user@gmail.com para Google, este último muestra una página de error que indica que el usuario ya existe.
• Las claves deben estar protegidas. Las claves solo debe usarlas el código del servidor. No deben estar disponibles en el cliente (.js, .html, etc.).

1. Inicie sesión en el portal para desarrolladores de Video Indexer API de Azure AI.
2. Suscríbase seleccionando la pestaña Productos . A continuación, seleccione Autorización y suscripción. Los nuevos usuarios se suscriben automáticamente a Authorization.
3. Busque, copie y guarde las claves principal y secundaria. Puede encontrar su suscripción en el perfil. Las claves principales y secundarias se encuentran en la sección Suscripciones .
4. Seleccione el vínculo Mostrar para la clave principal y la clave secundaria. Copie y péguelos en un editor de texto hasta que esté listo para usarlos en el archivo de variables de entorno.

Obtención de un token de acceso mediante authorization API

No quiere conceder acceso completo a todos los usuarios de la aplicación. Hay varios niveles de acceso para VI.

Nivel	Ver vídeos	Procesamiento de vídeos	Ver proyectos	Procesos de proyectos	Ver cuentas	Administrar cuentas
Lector de vídeo	✔️
Colaborador de vídeo	✔️	✔️
Lector de proyectos	✔️		✔️
Colaborador del proyecto	✔️	✔️	✔️	✔️
Lector de cuentas	✔️		✔️		✔️
Colaborador de la cuenta	✔️	✔️	✔️	✔️	✔️	✔️

Creación y envío de la solicitud de token de acceso

Establezca , subscription-idel , el resource-group-nameVI account-name en la solicitud y establezca el scope parámetro y permissionType en el cuerpo de la solicitud en el nivel de acceso que necesita.

Por ejemplo, si desea proporcionar acceso a un usuario para que pueda trabajar con proyectos, pero no puede trabajar con cuentas, establezca en permissionType "Colaborador" y en scope "Project". Si establece permisos para un proyecto, proporcione .projectId

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.VideoIndexer/accounts/{account-name}/generateAccessToken?api-version=2024-01-01

{
  "permissionType": "Reader",
  "scope": "Project",
  "projectId": "07ec9e38d4"
}

Respuesta de muestra

{
  "accessToken": "<jwt token of 1260 characters length>"
}

Para obtener más ejemplos de cómo establecer el ámbito y los tipos de permisos, consulte la API REST de VI.

Comience a usar la API

Está listo para empezar a usar la API. Busque la descripción detallada de cada API de REST de Video Indexer de Azure AI.

Para obtener un ejemplo detallado del uso de las claves en el archivo de variables de entorno y el uso de tokens de acceso, consulte el ejemplo de Azure AI Video Indexer.

Recomendaciones

• Cuando se llama a la API que obtiene información detallada del vídeo especificado, se obtiene una salida JSON detallada como contenido de la respuesta. Consulte más información sobre el código JSON devuelto en este artículo.
• La salida JSON generada por la API contiene los elementos Insights y SummarizedInsights. Se recomienda encarecidamente usar Insights y no usar SummarizedInsights (que está presente para la compatibilidad con versiones anteriores).
• No se recomienda usar datos directamente desde la carpeta de artefactos para fines de producción. Los artefactos son salidas intermedias del proceso de indexación y son salidas sin procesar de los distintos motores de IA que analizan los vídeos. El esquema de artefactos puede cambiar con el tiempo.
• Use Get Video Index API, como se describe en Obtención de conclusiones y artefactos generados por la API y noGet-Video-Artifact-Download-Url.