{"api":{"name":"PodClip API","version":"v1","base_url":"https://podclip.video/api/v1","description":"PodClip places any person in a photorealistic professional podcast studio using AI. Upload a selfie video clip, choose a studio scene, and receive a broadcast-quality MP4 with targeted eye restoration, optional captions, and perfect face identity preservation.","agent_friendly":true,"authentication":{"type":"Pro token (Bearer)","header":"X-Pro-Token","note":"Obtain a Pro token by subscribing at https://podclip.video. Free tier: 1 generation/week via web UI only."}},"endpoints":[{"method":"GET","path":"/api/v1/styles","description":"List all available studio scene presets with metadata.","auth_required":false,"response_example":{"success":true,"count":9,"styles":[{"id":"lex-minimal","name":"Lex Minimal","vibe":"clean, intellectual, premium"}]}},{"method":"GET","path":"/api/v1/presets","description":"List recommended caption + scene presets by content type (hot-take, executive, motivational, etc).","auth_required":false,"response_example":{"success":true,"count":5,"presets":[{"id":"hot-take","recommended_style":"dark-rogan","aspect_ratio":"9:16"}]}},{"method":"POST","path":"/api/jobs/start","description":"Start a new studio clip generation job. Accepts a selfie video file upload. Returns a job_id immediately — processing is async (typically 3-7 minutes). Poll GET /api/v1/job/:id for status.","auth_required":true,"content_type":"multipart/form-data","parameters":{"file":"Video file (MP4, MOV, WebM). Max 500MB. Required.","scene":"Studio scene ID. One of: lex-minimal, dark-rogan, diary-ceo, modern-studio, conversational, clean-studio, lofi-bedroom, black-screen, blurry-bg. Default: dark-rogan.","captions":"boolean — add animated captions to the clip. Default: true.","name":"string — your name, shown as lower-third in the clip.","title":"string — your title/role, shown as lower-third.","angle":"Camera angle: solo | tight | conv-left | conv-right. Default: solo.","output_format":"Aspect ratio: 16:9 | 9:16 | 1:1. Default: 16:9.","accessory":"Optional prop: cigar | whiskey | coffee | water | headphones | sunglasses."},"response_example":{"jobId":"abc123","status":"pending","message":"Job queued"}},{"method":"GET","path":"/api/v1/job/:id","description":"Poll job status. When status is 'completed', result_url contains the final MP4 download link.","auth_required":false,"response_example":{"success":true,"job":{"id":"abc123","status":"completed","progress":100,"result_url":"https://v3.fal.media/files/...","error":null}}}],"quality_notes":{"eye_restoration":"Every generated clip automatically receives targeted under-eye restoration: bags, dark circles, and puffiness are removed while all other facial features stay identical to the original. This is the only facial modification applied — bone structure, skin tone, facial hair, and face shape are untouched.","face_identity":"Face identity is preserved by Flux Kontext at guidance_scale=3.0 with 50 inference steps. The person looks exactly like themselves — in a different room.","pipeline":"Flux Kontext (img2img studio placement) → HeyGen Avatar4 (lip-sync animation) → FFmpeg (colour grade + captions)"},"pricing":{"free":"1 generation per week via web UI. No API access.","creator":"$49/month — unlimited generations, all 9 studio scenes, API access, no watermark.","pro_plus":"$99/month — everything in Creator plus 60-second clips, priority queue, and batch API."},"llm_instructions":"To generate a PodClip studio clip: (1) call POST /api/jobs/start with the video file and scene, (2) store the returned jobId, (3) poll GET /api/v1/job/{jobId} every 15 seconds until status='completed', (4) download the MP4 from result_url. The full pipeline takes 3-7 minutes. For best results: use lex-minimal for professional/founder content, dark-rogan for bold/authentic content."}