Uso de resumen textual

Se aplica a: Azure AI Video Indexer enabled by Azure Arc, Cloud-based Azure AI Video Indexer

En este artículo se muestra cómo usar el resumen de texto con Video Indexer de Azure AI. En este ejemplo se usan implementaciones de modelos de Azure OpenAI.

Nota:

Esta característica solo funciona con una cuenta de pago. Cree una cuenta de pago .

Requisitos previos

Revise la información general sobre el resumen de texto y los siguientes requisitos previos.

Nube

Una cuenta de pago de Video Indexer de Azure AI conectada a una cuenta de Azure OpenAI.
Acceso concedido a Azure OpenAI en la suscripción de Azure deseada. Actualmente, la aplicación concede acceso a este servicio. Para más información sobre cómo solicitar acceso a Azure OpenAI, consulte Acceso limitado para el servicio de Azure OpenAI.
Una implementación de Azure OpenAI de GPT-35-Turbo, GPT-4, GPT-4o o GPT-4O-mini. Para beneficiarse de los resúmenes basados en fotogramas clave, debe seleccionar un modelo de Azure OpenAI que acepte entradas visuales. Para obtener más información, consulte Modelos de servicio de OpenAI de Azure.
El filtro Escudos de indicaciones para ataques directos (jailbreak) debe agregarse a la implementación. Obtenga más información aquí: Uso de filtros de contenido (versión preliminar) con el servicio Azure OpenAI.
Se recomienda configurar filtros de contenido dañinos para categorías como "Violencia", "Odio", "Sexual" y "Auto-daño". Aunque estos filtros no son obligatorios, debe establecerlos en "Medio" o "Bajo" para filtrar el contenido de al menos el nivel medio de daño. Esta configuración garantiza que el contenido con una clasificación de daños de medio o superior está bloqueado. Para aumentar la seguridad, puede optar por una configuración más estricta. Una vez configurado, guarde la configuración del filtro de contenido.
Vídeo cargado en la biblioteca de Video Indexer de Azure AI.

Nota:

Video Indexer de Azure AI no puede conectarse a los modelos ajustados.

Dispositivos de borde

Video Indexer de Azure AI habilitado por Arc permite usar Video Indexer de Azure AI en dispositivos perimetrales. A continuación se muestran los requisitos técnicos para este caso de uso:

Video Indexer habilitado por Arc con el número de versión 1.1.23 o superior.
Requisitos de hardware: GPU o CPU Intel. No se recomienda ejecutar en CPU debido a una velocidad lenta. Se recomienda usar GPU Nvidia V100 o posteriores. Si hay varios nodos de GPU, puede agregar un selector de nodos para seleccionar el nodo deseado.
Usar fotogramas clave como parte del resumen requiere Nvidia A100 o superior.
El resumen de vídeo textual en el perímetro solo usa el modelo Phi3.5. Para obtener más información de hardware, consulte la información oficial de la versión Phi 3.5.

Abrir páginas web en el explorador

Es más fácil seguir estas instrucciones si ya tiene abiertas las páginas web necesarias. Copie y pegue los parámetros siguientes en su editor de texto favorito. Esta es una lista para empezar:

ID de cuenta VI
id. de archivo de vídeo:
nombre de implementación:
token de acceso:

Abra Azure Portal en una pestaña o ventana e inicie sesión.
1. Vaya a la página de la cuenta de Azure AI Video Indexer para el ID de cuenta.
2. Vaya a la página de la cuenta de Azure OpenAI.
  1. En el menú, seleccione Implementaciones de modelos y, a continuación, seleccione Administrar implementaciones. Se abre Azure OpenAI Studio. Copie el nombre de implementación que desea usar.
Abra el portal web de Azure AI Video Indexer en otra pestaña o ventana e inicie sesión.
1. Vaya a la página de la biblioteca, elija un vídeo y haga clic con el botón derecho en él para el identificador de archivo de vídeo.
Abra Azure AI Video Indexer API en otra pestaña o ventana e inicie sesión.

Telaraña
API

Generar un resumen de texto con o sin fotogramas clave

Puede usar el portal web de Video Indexer de Azure AI para resumir el texto.

Si aún no tiene el portal web abierto, abra el portal web de Azure AI Video Indexer.
Cargue un archivo y espere a que se indexe.
Seleccione el vídeo para ir a la página multimedia.
Si desea usar fotogramas clave para generar el resumen, seleccione la opción Incluir información de fotograma clave visual para obtener una mejor calidad de resumen.
Seleccione Generar resumen. Se genera el resumen textual.

Nota:

Si no ve el botón Generar resumen, es posible que esté usando una cuenta de prueba. Para usar esta característica, cree una cuenta estándar .

Personalizaciones de resumen

Una vez generado el resumen, puede realizar ajustes en él personalizando el estilo de resumen o cambiando la implementación del modelo.

Personalización del estilo de resumen

También puede personalizar el resumen seleccionando el icono Personalizar resumen . Puede elegir entre longitudes de resumen corto, medio o largo , y puede elegir Neutral, Casual o Formal como estilo de resumen. Una vez que elija las opciones, seleccione Generar de nuevo.

Cambio de la implementación del modelo

Seleccione el icono Personalizar resumen .
Seleccione la implementación de modelos que desea usar en la lista desplegable Implementación de modelos.
Seleccione Generar de nuevo.

Nota:

Recuerde que la implementación del modelo es una combinación del modelo y los filtros. Además, cada vez que personalice el resumen de texto, representa una solicitud PUT de API.

Creación de un resumen de vídeo

Generar token de acceso

Genere un token de acceso en Azure Portal:

Vaya a la cuenta de Video Indexer de Azure AI.
En el menú, seleccione Management (Administración ) y Management API (API de administración).
En la lista desplegable Tipo de permiso , seleccione Colaborador.
En la lista desplegable Ámbito, seleccione Cuenta.
Selecciona Generar. Se genera el token de acceso.
Copie el token de acceso en el Portapapeles.

Debe tener todos los parámetros necesarios para crear un resumen de vídeo listo para usar en su editor de texto.

En la página API de Video Indexer de Azure AI, busque resumen.
Seleccione el botón Pruébelo situado junto a Crear resumen de vídeo. Se abre el panel Parámetros de API.
Pegue el token de acceso desde el portapapeles en el campo accessToken.
Seleccione la ubicación en la lista desplegable de ubicaciones.
Copie y pegue el identificador de cuenta VI en el campo accountId .
Copie el identificador del archivo de vídeo y péguelo en el campo videoId .
Elija la longitud del resumen, medio, corto o largo, en la lista desplegable de longitud .
Elija el estilo, neutro, casual o formal, en la lista desplegable estilo .
Seleccione Enviar.

La respuesta contiene un identificador de resumen. Copie ese identificador en el portapapeles.

Personalización de un resumen de vídeo textual

Personalice el resumen de texto con el parámetro opcional addToEndOfSummaryInstructions en Create Video Summary API. Use este parámetro para mejorar el resumen textual del vídeo mediante la inclusión de información adicional en lenguaje natural. Por ejemplo, puede usarlo para incluir información sobre las personas que aparecen, temas generales tratados y marcas mencionadas en el vídeo.

Personalizar el resumen garantiza que el resumen de vídeo sea completo y adaptado a sus necesidades.

Para personalizar un resumen:

Acceda a la API de Video Indexer. Debe realizar una llamada POST a Create Video Summary API.
Agregue el parámetro addToEndOfSummaryInstructions. Incluya el &addToEndOfSummaryInstructions=["Your prompt"] parámetro en la dirección URL al realizar la llamada POST. Este parámetro es opcional y se puede usar para agregar información adicional al resumen. "Su solicitud" es la información adicional que desea incluir en el resumen.
La dirección URL codifica el parámetro . Asegúrese de que la información adicional está codificada en dirección URL. Por ejemplo, si desea agregar "las personas conocidas o celebridades que aparecen en el vídeo, los temas generales del vídeo y todas las marcas mencionadas en él", use: &addToEndOfSummaryInstructions=the+known+people+or+celebrities+appearing+in+the+video+the+general+topics+of+the+video+and+all+of+the+brands+mentioned+in+it.

Este es un ejemplo de cómo usar el addToEndOfSummaryInstructions parámetro :

POST
https://api.videoindexer.ai/{location}/Accounts/{accountId}/Videos/{videoId}/Summaries/Textual?deploymentName={deploymentName}&includedFrames={None/Keyframes}&addToEndOfSummaryInstructions=the+known+people+or+celebrities+appearing+in+the+video+the+general+topics+of+the+video+and+all+of+the+brands+mentioned+in+it

La llamada POST de ejemplo da como resultado un resumen que termina con contenido semejante a:

Known people or celebrities appearing in the video: Satya Nadella
General topics: Technology, Microsoft Build Keynotes, AI, GenAI
Brands mentioned: Microsoft, Phi Models.

Obtener un resumen de vídeo

En primer lugar, compruebe el estado del resumen. Hasta que finalice el trabajo de resumen, el valor de estado muestra "Procesamiento", pero no hay ningún resumen en la respuesta. Cuando finalice el trabajo de resumen, el resumen se muestra en la respuesta.

Seleccione GET Video Summary (Obtener resumen de vídeo).
Escriba el identificador de cuenta, el identificador de vídeo, el identificador de resumen y el token de acceso en los campos adecuados.
Seleccione Enviar.

Nota:

Siempre hay una declinación de responsabilidades disponible en la respuesta sobre el resumen. Además, hay un vínculo a la API de estado del trabajo en el encabezado Ubicación.

Puede enumerar los resúmenes de vídeo por página. Seleccione GET List Video Summaries y use los mismos parámetros ya descritos. Si hay una lista grande de resúmenes, use los parámetros de página para devolver la respuesta en las páginas. Use el identificador de resumen de la solicitud Obtener resumen de video.

Eliminar un resumen de vídeo

Eliminar el resumen de vídeo es tan simple como seleccionar ELIMINAR RESUMEN DE VÍDEO, usando los mismos parámetros y seleccionando Enviar.

Códigos de error

Solicitud	código de estado	Mensaje de error	Tipo de error	Motivo	Mitigación

Crear-Resumen-de-Video	400	La cuenta no está conectada a Azure OpenAI	ENTRADA_NO_VÁLIDA		Vaya a Azure Portal y conecte una cuenta.
Crear-Resumen-de-Video	400	No se encontró ninguna implementación con este nombre: {deploymentName}	ENTRADA_NO_VÁLIDA		Compruebe la cadena de nombre de implementación.
Crear-Resumen-de-Video	400	Este modelo no admite la generación de resúmenes.	ENTRADA_NO_VÁLIDA		Elección de un modelo diferente
Crear-Resumen-de-Video	400	No se pudo generar un resumen porque el modelo de IA debe tener filtros de contenido agregados para evitar mostrar contenido perjudicial. " + $"Agregue las siguientes directivas: {string.Join(",", Enum.GetValues<FilterType>().Where(type => type != FilterType.JailBreak))}." + $"Establezca AllowedContentLevel en al menos {AllowedContentLevel.Medium} para ambas fuentes {FilterSource.Prompt} y {FilterSource.Completion}	FILTROS_DEL_RESUMEN_NO_ENCONTRADOS		Consulte el mensaje de error.
Crear-Resumen-de-Video	400	No se encontró el vídeo	VIDEO_NO_ENCONTRADO
Crear-Resumen-de-Video	400	La indexación de vídeo aún no ha finalizado correctamente	VIDEO_YA_EN_PROGRESO
Crear-Resumen-de-Video	400	Valor de longitud de resumen no válido '{length}'	ENTRADA_NO_VÁLIDA
Crear-Resumen-de-Video	400	Valor de estilo de resumen no válido '{style}	ENTRADA_NO_VÁLIDA
Obtener-Resumen-Del-Video	200	NOD	NOD
Obtener-Resumen-Del-Video	404	No se encontró el resumen '{summaryId}' para el vídeo '{videoId}'	NO_ENCONTRADO
Obtener-Resumen-Del-Video	200	No se pudo generar un resumen porque el contenido del vídeo se marcó como perjudicial. Para obtener más información, consulte Filtros de contenido.	NOD	Todas las secciones del vídeo han desencadenado el filtro de contenido.	No hay ninguna solución para el vídeo específico.
Obtener-Resumen-Del-Video	200	No hay suficiente información para generar el resumen.	NOD	La información del vídeo no contienen suficiente información para crear indicaciones para Azure OpenAI.	Si el valor preestablecido del vídeo no contiene todos los modelos, volver a indexar con un valor preestablecido más avanzado que contenga audio podría ayudar.
Obtener-Resumen-Del-Video	200	No se pudieron obtener implementaciones de Azure OpenAI para el recurso {_resourceName}
Obtener-Resumen-Del-Video	200	La implementación {DeploymentName} no existe
Obtener-Resumen-Del-Video	200	No se pudo acceder a Azure OpenAI. Intente volver a ejecutar el resumen más adelante.			Intente resumir el trabajo de nuevo más tarde.
Crear-Resumen-de-Video				Sin asignación de roles
Obtener-Resumen-Del-Video				Sin asignación de roles

Solución de problemas

Antes de buscar soluciones específicas, asegúrese de crear los recursos en la sección Requisitos previos del documento.

No aparece "Generar resumen"

Es posible que la cuenta de Azure OpenAI esté conectada a la cuenta de Azure AI Video Indexer incorrectamente.

No se pudo generar el resumen

Debe agregar filtros de contenido a la implementación para evitar mostrar contenido perjudicial. Vuelva a Azure OpenAI Studio y agregue filtros a la implementación.
Ha creado un filtro de contenido permisivo para el contenido que tiene contenido confidencial o dañino. El filtro de contenido debe ser al menos medio. Si estableces el filtro de contenido en Medio y el contenido dañino permanece en el vídeo, se activa el filtro. En este caso, no hay ninguna solución.
No solicitó una transcripción o es posible que no haya suficiente información generada durante el proceso de indexación.
Es posible que esté usando un valor preestablecido avanzado.
Es posible que el vídeo no tenga suficiente audio en él para crear una transformación.

No se puede usar una implementación de modelo o falta la implementación

No ha creado una implementación.
Alguien cambió o eliminó el modelo implementado.

Limitaciones

Puede haber demasiadas solicitudes enviadas a VI. Espere unos minutos y vuelva a intentarlo.

Recibe el error "no se encontró el filtro"

Si recibe un error porque no se encontró el filtro, obtendrá un mensaje detallado que describe lo que falta. El error podría parecerse al ejemplo siguiente, pero podría tener detalles sobre otras cosas que faltan:

ErrorType":"SUMMARY_FILTERS_NOT_FOUND","Message":"Couldn't generate a summary because the model needs to be set with the right content filters to avoid showing harmful content. Input filter 'Jailbreak' must be enabled with action set to 'Annotate and block'. Trace id: '00000000-0000-0000-0000-000000000000'.

Nota:

El filtro de jailbreak solo es necesario cuando se utiliza un resumen basado en fotogramas clave o un resumen normal, a partir del 1 de noviembre de 2024.

Para resolver el problema del jailbreak:

Seleccione Ir a Azure Open AI Studio.
Seleccione Implementaciones.
Seleccione la implementación con la que está trabajando.
Seleccione Editar.
Configure los filtros para que tengan al menos nivel Medio para cada categoría.
Aplique escudos de protección para ataques de jailbreak.
Seleccione Crear filtro.

Otras consideraciones

Se recomienda crear las cuentas de Azure AI Video Indexer y Azure OpenAI en la misma región o podría experimentar problemas de rendimiento.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-10-06

Uso de resumen textual

Requisitos previos

Nube

Dispositivos de borde

Abrir páginas web en el explorador

Generar un resumen de texto con o sin fotogramas clave

Personalizaciones de resumen

Personalización del estilo de resumen

Cambio de la implementación del modelo

Solución de problemas

No aparece "Generar resumen"

No se pudo generar el resumen

No se puede usar una implementación de modelo o falta la implementación

Limitaciones

Recibe el error "no se encontró el filtro"

Otras consideraciones

Comentarios

Recursos adicionales