APIAPI Generazione Video IA

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.generate

Ottieni una chiave Riferimento API

Tre chiamate, dall'inizio alla fine

Scegli il motore una volta, poi genera quanto vuoi.

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"

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
  }'

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_id

L'agente video da eseguire. Il suo motore e i suoi preset decidono l'aspetto della clip.

prompt

Cosa deve succedere nell'inquadratura. Il motore lo legge come farebbe un regista.

image_url

Opzionale. Un fermo immagine da animare invece di generare dal solo testo.

duration

Secondi 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.

VeoKlingSoraSeedanceRunway

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.failed

Le 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.

Specifica OpenAPI Codici di errore Esplora l'API