API de VisionStory
diseñada para desarrolladores

Una API de vídeo de avatar con IA convierte un presentador digital, junto con texto o audio grabado, en un vídeo con sincronización labial que una aplicación puede generar de forma programática. VisionStory acepta solicitudes autenticadas del lado del servidor, devuelve un ID de vídeo de inmediato, renderiza el trabajo de forma asíncrona y proporciona una URL MP4 cuando la generación se completa.

Crea una clave de API de VisionStory, verifica tus créditos, obtén los ID actuales de modelo, avatar y voz, y luego envía un text_script o un audio_script a POST /api/v1/video. La API devuelve un ID de vídeo de inmediato. Consulta el estado del trabajo aproximadamente cada cinco segundos hasta que sea created y, después, descarga el MP4 desde video_url.

Usa REST cuando necesites un control independiente del lenguaje, el SDK de Python cuando estés creando un servicio o un notebook en Python, y la CLI para automatización en terminal, CI o generación por lotes. Las tres interfaces usan los mismos recursos de VisionStory y el mismo flujo de trabajo de vídeo asíncrono.

Sí. Instala la VisionStory Agent Skill o conecta el servidor MCP de VisionStory. Un agente de programación compatible puede verificar créditos, listar los modelos, avatares y voces actuales, preparar una solicitud válida, iniciar el trabajo de vídeo, supervisarlo y descargar el resultado mientras la clave de API permanece en tu entorno o en el almacén de secretos de MCP.

Sí. Envía un audio_script cuando quieras que el avatar hable a partir de audio grabado, o envía un text_script con un ID de voz cuando VisionStory deba sintetizar el habla. Usa un solo tipo de script por solicitud, en lugar de enviar ambos.

Trata la creación de vídeo como un trabajo asíncrono. Guarda el ID de solicitud del cliente y el ID de vídeo devuelto, consulta aproximadamente cada cinco segundos y detente cuando el trabajo llegue a created o failed. Las URL de los vídeos completados se conservan durante siete días, así que copia el contenido finalizado a tu propio almacenamiento permanente cuando sea necesario.

Guarda VISIONSTORY_API_KEY en una variable de entorno del servidor, un secreto de CI o el almacén de secretos del cliente MCP, y envíala mediante el encabezado de solicitud X-API-Key. Nunca incrustes la clave en código del navegador, el paquete de una app móvil, un repositorio público, capturas de pantalla, logs o un mensaje de chat con IA.

Puedes combinar el vídeo de avatar con texto a voz, voces públicas o clonadas, recursos reutilizables de imagen y audio, transcripción, generación de imágenes con IA y modelos de vídeo de vanguardia. Estos componentes permiten explicativos localizados, contacto personalizado, contenido de aprendizaje automatizado y flujos de trabajo de medios con agentes de IA.