Referencia API
Autentícate con tokens de sesión de Supabase. Todas las respuestas comparten la forma { success: boolean, data, error } para mantener la UI consistente.
/api/projects
Crea un registro de proyecto antes de generar frames. Devuelve un projectId usado en los endpoints.
{
"title": "Product teaser",
"textPrompt": "Hero stands on cliff at dawn",
"description": "Keep outfit consistent with uploaded still"
}/api/projects/generate/first-frame
Inicia la generación con IA. Requiere projectId más una ruta opcional de imagen de referencia.
{
"projectId": "<projectId>",
"referenceImagePath": "projects/ref.png"
}/api/projects/generate/:step?predictionId=<id>&projectId=<id>
Consulta los resultados de predicción. Pasos: first-frame, last-frame, video.
Configura una URL de webhook en el panel. Los eventos se firman con un secreto HMAC que puedes rotar en cualquier momento.
generation.succeeded
Un frame o video terminó de procesarse.
generation.failed
Replicate o la cola interna devolvió un error. Reintenta tras revisar payload.error.
project.created
Confirmación de que los metadatos se guardaron en Supabase, útil para sincronizar CRM.