Riferimento API
Autenticati con i token di sessione Supabase. Tutte le risposte condividono la forma { success: boolean, data, error } per mantenere coerente la UI.
/api/projects
Crea un record di progetto prima di generare i frame. Restituisce un projectId usato dagli endpoint.
{
"title": "Product teaser",
"textPrompt": "Hero stands on cliff at dawn",
"description": "Keep outfit consistent with uploaded still"
}/api/projects/generate/first-frame
Avvia la generazione AI. Richiede projectId più un percorso immagine di riferimento opzionale.
{
"projectId": "<projectId>",
"referenceImagePath": "projects/ref.png"
}/api/projects/generate/:step?predictionId=<id>&projectId=<id>
Interroga i risultati di predizione. Passi: first-frame, last-frame, video.
Configura un URL webhook nella dashboard. Gli eventi sono firmati con un segreto HMAC che puoi ruotare in qualsiasi momento.
generation.succeeded
Un frame o video ha terminato l'elaborazione.
generation.failed
Replicate o la coda interna ha restituito un errore. Riprova dopo aver controllato payload.error.
project.created
Conferma che i metadati sono stati salvati in Supabase, utile per la sincronizzazione CRM.