Genera vídeo con IA
desde tu propio backend
Un POST convierte un prompt, o una imagen fija, en un clip generado. Veo, Kling, Sora y Seedance tras un único endpoint, cobrados por generación y entregados por webhook.
POSThttps://autostud.ai/api/v1/actions/videos_ai.generateTres llamadas, de principio a fin
Elige el motor una vez y genera tantas veces como quieras.
- 1
Elige un agente de vídeo
Un agente es una configuración de modelo guardada: motor, resolución, formato y valores por defecto. Lista los de tu espacio y guarda el id.
export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # A video agent is a saved model configuration, not a model name. curl "https://autostud.ai/api/v1/agents?agent_type=video&limit=10" \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" - 2
Envía el prompt
Solo texto, o una imagen fija para animar. La respuesta trae un id de generación y los créditos que gastó.
curl -X POST https://autostud.ai/api/v1/actions/videos_ai.generate \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: lighthouse-shot-01" \ -d '{ "agent_id": "b21f7d90-3c44-4e1a-9f77-0c2ad5e6b118", "prompt": "A lighthouse at dusk, slow push-in, waves breaking under it", "duration": 8 }' - 3
Recoge el clip
Toma el webhook generation.completed, o vuelve a leer la generación si prefieres sondear. La URL alojada está en el registro.
# Register once. Every generation reports itself from then on. curl -X POST https://autostud.ai/api/v1/webhooks \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-app.com/hooks/autostud", "events": ["generation.completed", "generation.failed"], "description": "AI video" }' # The signing secret comes back once, in this response. Store it.
Lo que puedes enviar
Cuatro campos. El resto vive en el agente, así que tus llamadas siguen siendo cortas.
agent_idEl agente de vídeo que se ejecuta. Su motor y sus ajustes deciden cómo se ve el clip.
promptLo que debe ocurrir en el plano. El motor lo lee como lo haría un director.
image_urlOpcional. Una imagen fija para animar en vez de generar solo desde el texto.
durationSegundos de metraje a producir, dentro del rango que soporta el motor.
Motores detrás del endpoint
Cada motor se expone como un agente: cambiar de modelo es un id distinto, no una integración distinta. Los motores nuevos llegan como agentes nuevos.
Deja de sondear
Registra un webhook y cada generación se anuncia sola. Los payloads van firmados, se reintentan y llevan los créditos gastados incluso cuando la generación falla.
generation.completedgeneration.failedLo primero que preguntan los desarrolladores
¿Cuánto tarda una generación?
Depende del motor y de la duración: unos segundos de vídeo cuestan minutos de cómputo. La llamada devuelve un id al instante, así que nada en tu app se queda esperando.
¿Cuánto cuesta?
Las generaciones se cobran en créditos, con precio por motor. Cada respuesta informa de los créditos gastados y el historial completo se lee en /api/v1/generations.
¿Puedo animar una imagen que ya tengo?
Sí. Envía image_url con cualquier imagen accesible públicamente y el motor la anima en lugar de partir solo del prompt.
¿Puedo alargar el clip después?
Llama a videos_ai.extend con el id de la generación y un prompt para el siguiente segmento. La extensión es una generación propia y se cobra igual.
¿Listo para crear?
Comienza a generar videos virales en minutos. No se requiere tarjeta de crédito para la prueba gratuita.