{"service":"dfl-render","version":"0.1.0","endpoints":["POST /media/recording-source (resolve an exact caller-visible saved public recording; read-only)","GET /health","GET /media/poster/:id.jpg (PUBLIC; 302 to the JPEG poster of export media/lesson-renders/<id>.mp4, generated on first request; 404 when the MP4 is missing; 503 + Retry-After when busy)","GET /metrics","POST /render/composition/preflight (caller-owned authored timeline, provider limits and route plan; no render submission)","POST /media/paired-silence (caller-owned async narration source-clock silence proposals; no edits)","GET /media/paired-silence/:job_id (caller-owned durable proposal analysis)","POST /media/paired-silence/apply (pure accepted source-cut map; stale detection and repeat idempotency; caller persists through RLS)","POST /upload/signed/init (presign one PUT of a large private file; user JWT)","POST /upload/signed/complete (verify the signed object and register its public.media row with the caller JWT)","POST /upload/multipart/init (start an authenticated direct-to-S3 multipart upload)","POST /upload/multipart/part (create an authenticated exact-length part URL)","POST /upload/multipart/complete (verify and complete an authenticated multipart upload; without parts, the server derives them from S3; the upload_token alone authorizes it)","POST /upload/multipart/status (the parts that S3 holds and the missing parts, for a resume; the upload_token alone authorizes it)","POST /upload/multipart/parts (batch exact-length part URLs, life up to 24 h, for a native background upload; the upload_token alone authorizes it)","POST /render/lesson/fast (server-side per-slide render + concat → MP4; requires Supabase user JWT)","POST /render/composition (TRULY-ASYNC server-side FULL-COMPOSITION render — returns 202 + job_id immediately; heavy work + provider (local ffmpeg / remotion-lambda) submit run on a background worker pool that outlives the request; optional slide_ids (uuid[], max 50) renders only those slides; composition-scoped + deleted_at filter + screen/webcam PiP compositing; requires Supabase user JWT)","GET /render/composition/:job_id (poll the composition render lifecycle: queued → transcoding → submitted → rendering → done/failed, with output URL/error; requires Supabase user JWT)","POST /render/split (cut an already-rendered MP4 from the media bucket into ordered Instagram Story parts, each 3–60 s (default max 59 s), cut on caller boundaries or detected scene changes; re-encoded, uploaded to media/story-parts/<job_id>/; returns 202 + job_id; additive, does not touch /render/composition; requires Supabase user JWT)","GET /render/split/:job_id (poll a split job: queued → running → done/failed, with parts [{index,url,start_s,duration_s}], total_duration_s, boundary_source, boundaries_refined_s (caller boundaries snapped to the visible slide change); owner only; requires Supabase user JWT)","POST /media/cut (cut one media file into 1–50 re-encoded parts by [start_s,end_s] ranges, each ≥ 0.3 s; fit none | portrait-crop | portrait-letterbox (1080x1920 30 fps); source_url https on the transcode host allowlist incl. media.devfellowship.com, ≤ 3 allowlisted redirect hops; uploaded to media/media-cuts/<job_id>/; returns 202 + job_id; requires Supabase user JWT)","GET /media/cut/:job_id (poll a cut job: queued → running → done/failed, with parts [{index,url,start_s,end_s,duration_s,width,height}], source_duration_s, error; owner only; requires Supabase user JWT)","POST /media/transcribe (transcribe one media file: mono MP3 extract, the transcribe-audio edge function AS THE CALLER (word timestamps), caption cues built with the Lesson Studio rules; language auto | pt | en; optional translate_to (ISO code) translates cue by cue keeping each cue's timing; same source_url guard as /media/cut; returns 202 + job_id; requires Supabase user JWT)","GET /media/transcribe/:job_id (poll a transcribe job: queued → running → done/failed, with source_url, audio_url, language, duration_s, text, words [{word,start,end}], segments [{start,end,text}], cues [{text,startMs,endMs}], translated? {language, cues | error}, error; owner only; requires Supabase user JWT)","POST /media/import-url (import a clip from an allowlisted social/video URL — x.com, twitter.com, youtube.com, youtu.be, instagram.com, tiktok.com, vimeo.com; env IMPORT_URL_HOSTS — with yt-dlp (fixed argv, host extractor only, no playlist, size/duration caps, timeout), trim start_s/end_s (≤ 180 s), fit portrait-letterbox (default) | portrait-crop | none, upload to media/media-imports/<job_id>/clip.mp4, then transcribe (default true; language, translate_to) as the caller; returns 202 + job_id; requires Supabase user JWT)","GET /media/import-url/:job_id (poll an import job: queued → running → done/failed, with media {url,duration_s,width,height}, source {url,title?,uploader?}, transcription (the /media/transcribe result shape, or {error}, or null), error; owner only; requires Supabase user JWT)","POST /media/export-check (machine review of one finished export MP4: ffprobe duration/size vs expected_duration_s, blackdetect ranges, JPEG frames at every slide start/mid/end from slide_boundaries_s uploaded to media/export-checks/<job_id>/, and a caption/face overlap flag per mid-slide frame from one vision-LLM call (face_check, default true); same source_url guard as /media/cut; returns 202 + job_id; requires Supabase user JWT)","GET /media/export-check/:job_id (poll an export-check job: duration_s, duration_gap_s, width, height, slides, black_ranges, frames [{slide,at,time_s,url,face?,captions?,caption_over_face?}], face_check, flags, error; owner only; requires Supabase user JWT)","POST /render/slide (server-side per-slide render → segment cache; requires Supabase user JWT)","POST /transcode/audio (FFmpeg audio transcode + studio-sound enhance + middle-silence removal; requires Supabase user JWT; source_url host allowlist)","POST /transcode/audio-extract (extract a transcript-ready mono MP3 at 64 kbps; requires Supabase user JWT; HTTPS source_url host allowlist)","POST /transcode/motion-jumpcut (FFmpeg middle-silence jump-cut for motion video; flag-gated, fail-open; requires Supabase user JWT; source_url host allowlist)","POST /transcode/video (FFmpeg VP9/WebM → H.264/MP4 so the composition render can composite webcam/screen video; fail-closed; requires Supabase user JWT; source_url host allowlist)","POST /transcode/slide-media (PRE-TRANSCODE-AT-UPLOAD: origin=server (default) → async background WebM→H.264 (fast profile) + write transcoded_storage_path/transcode_status on the slide_media row, returns 202; origin=client → record a client WebCodecs H.264 result, returns 200; slide_media_id OPTIONAL (best-effort row write); graceful when columns absent; requires Supabase user JWT; source_url host allowlist)","POST /transcode/slide-media/report (CLIENT-ORIGIN report: record a client WebCodecs H.264 (transcoded_url) on the slide_media row, returns 200; slide_media_id OPTIONAL; requires Supabase user JWT; transcoded_url host allowlist)","POST /capture/slide (headless slide screenshot → S3; requires Supabase user JWT)","POST /capture/composition-zip (headless screenshot of every live slide in a composition, zipped, uploaded to S3 → zip_url; portrait projects prefer the social-portrait 1080x1350 canvas, falling back to the project's own canvas if a template hasn't opted in; requires Supabase user JWT)","GET /render-view/data/:slideId (signature-gated slide payload)","POST /concat/video (delegates to dfl-runner concat worker)","POST /share-links (Lesson Studio share link for a composition, public or members; starts or reuses the render; owner/editor; requires Supabase user JWT)","GET /share-links (the active share link of ?composition_id=, with the render state; owner/editor; requires Supabase user JWT)","PATCH /share-links/:id (change visibility or revoke; owner/editor; requires Supabase user JWT)","POST /share-links/:id/refresh (Update video: reuse the render of unchanged content, else start a new one; owner/editor; requires Supabase user JWT)","GET /v/:token (PUBLIC watch page of a share link: SSR, Open Graph tags, player or render progress; members link checks the dfl_auth cookie; 404 unknown, 410 revoked)","GET /v/:token/status (PUBLIC polling JSON of a share link: state rendering|ready|failed, progress, eta_s, video_url, poster_url; members link answers 401 + login_url without a session)","GET /room/ice-servers (ICE server list for the multiplayer room WebRTC monitor: STUN plus, when ROOM_TURN_URLS and ROOM_TURN_AUTH_SECRET are set, a TURN entry with a short-lived coturn REST credential; Cache-Control no-store; requires Supabase user JWT)","GET /v/:token/og.jpg (PUBLIC stable og:image of a share link, 1280x720 JPEG, never an error for a live link: frame-0 poster after the render, a first-slide still during it, else a generic card; a members link gets the generic private card only; 404 unknown, 410 revoked)"]}