API Reference
Authenticate with Supabase session tokens. All responses share the shape { success: boolean, data, error } to keep the UI consistent.
/api/projects
Create a project record before generating frames. Returns a projectId used across endpoints.
{
"title": "Product teaser",
"textPrompt": "Hero stands on cliff at dawn",
"description": "Keep outfit consistent with uploaded still"
}/api/projects/generate/first-frame
Kick off AI generation. Requires projectId plus optional reference image path.
{
"projectId": "<projectId>",
"referenceImagePath": "projects/ref.png"
}/api/projects/generate/:step?predictionId=<id>&projectId=<id>
Poll prediction results. Steps: first-frame, last-frame, video.
Configure a webhook URL inside the dashboard. Events are signed with an HMAC secret that you can rotate at any time.
generation.succeeded
A frame or video finished processing.
generation.failed
Replicate or internal queue returned an error. Retry after inspecting payload.error.
project.created
Confirmation that metadata saved to Supabase, useful for CRM sync.