Genera video IA
dal tuo backend
Un POST trasforma un prompt, o un fermo immagine, in una clip generata. Veo, Kling, Sora e Seedance dietro un solo endpoint, fatturati a generazione e consegnati via webhook.
POSThttps://autostud.ai/api/v1/actions/videos_ai.generateTre chiamate, dall'inizio alla fine
Scegli il motore una volta, poi genera quanto vuoi.
- 1
Scegli un agente video
Un agente è una configurazione di modello salvata: motore, risoluzione, formato, valori predefiniti. Elenca quelli del tuo spazio e tieni l'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
Invia il prompt
Solo testo, oppure un fermo immagine da animare. La risposta restituisce un id di generazione e i crediti spesi.
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
Ritira la clip
Prendi il webhook generation.completed, o rileggi la generazione se preferisci il polling. L'URL ospitato è sul record.
# 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.
Cosa puoi passare
Quattro campi. Il resto vive sull'agente, così le chiamate restano brevi.
agent_idL'agente video da eseguire. Il suo motore e i suoi preset decidono l'aspetto della clip.
promptCosa deve succedere nell'inquadratura. Il motore lo legge come farebbe un regista.
image_urlOpzionale. Un fermo immagine da animare invece di generare dal solo testo.
durationSecondi di girato da produrre, entro l'intervallo supportato dal motore.
I motori dietro l'endpoint
Ogni motore è esposto come agente: cambiare modello è un id diverso, non un'integrazione diversa. I nuovi motori arrivano come nuovi agenti.
Smetti di fare polling
Registra un webhook e ogni generazione si annuncia da sola. I payload sono firmati, riprovati e riportano i crediti spesi anche quando la generazione fallisce.
generation.completedgeneration.failedLe prime domande degli sviluppatori
Quanto dura una generazione?
Dipende dal motore e dalla durata: pochi secondi di video costano minuti di calcolo. La chiamata restituisce subito un id, quindi nella tua app non aspetta nulla.
Quanto costa?
Le generazioni si pagano in crediti, con prezzo per motore. Ogni risposta indica i crediti spesi e lo storico completo si legge su /api/v1/generations.
Posso animare un'immagine che ho già?
Sì. Passa image_url con qualsiasi immagine raggiungibile pubblicamente e il motore la anima invece di partire dal solo prompt.
Posso allungare la clip dopo?
Chiama videos_ai.extend con l'id della generazione e un prompt per il segmento successivo. L'estensione è una generazione a sé, fatturata allo stesso modo.
Pronto a creare?
Inizia a generare video virali in pochi minuti. Nessuna carta di credito richiesta per la prova gratuita.