Media ingest

V1 uses hybrid ingest.

Multipart path

POST /v1/frame-submissions accepts metadata plus PNG or other configured small media. This path is optimized for the normal next-frame case.

The API validates:

• bearer API key scope,
• idempotency key reuse,
• content type,
• byte size,
• metadata core fields,
• channel permission.

Large video path

Large video uses POST /v1/media-uploads, which creates the frame submission and opens a Cloudflare Stream upload session in one call (carrying the same metadata as frame-submissions). Cloudflare Stream is the primary source of truth for those videos; the submission advances as the Stream webhook reports progress.

This avoids proxying large video through Supabase Edge Functions.

Delivery promotion

Media processing creates or updates frame_media rows. The workbench should show original status, delivery provider, Cloudflare asset ID, and whether signed delivery is ready.