{"openapi":"3.1.0","info":{"title":"Pitchstage Headless API","version":"v1","description":"Drive Pitchstage headlessly: create a project from a folder of screenshots, run a cheap `plan` (resolved config + preview frames + fit-score + warnings), iterate, then `render` an isolated variant. Auth is a workspace API key (`Authorization: Bearer pk_live_…`)."},"servers":[{"url":"/api"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A workspace API key (pk_live_…)."}},"schemas":{"Intent":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"artifactType":{"type":"string","enum":["demo_video_landscape","linkedin_carousel","launch_copy"]},"goal":{"type":"string","minLength":1,"maxLength":500},"audience":{"type":"string","enum":["founders","developers","enterprise","consumer","existing_users","waitlist"]},"tone":{"type":"string","enum":["warm","direct","playful","technical","urgent"]},"aspect":{"type":"string","enum":["16:9","9:16","1:1"]},"targetLengthS":{"anyOf":[{"type":"integer","minimum":10,"maximum":600},{"type":"null"}]},"captionStyle":{"type":"string","enum":["karaoke","plain","sparse","off"]},"brandKitId":{"anyOf":[{"type":"string","pattern":"^brk_[0-9a-z]{12}$"},{"type":"null"}]},"voiceProfileId":{"anyOf":[{"type":"string","pattern":"^vp_[0-9a-z]{12}$"},{"type":"null"}]}},"required":["artifactType","goal","audience","tone","aspect","targetLengthS","captionStyle","brandKitId","voiceProfileId"],"additionalProperties":false},"Director":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"outline":{"type":"object","properties":{"hook":{"type":"string"},"problem":{"type":"string"},"solution":{"type":"string"},"beats":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"}},"required":["title"],"additionalProperties":false}},"callToAction":{"type":"string"},"close":{"type":"string"}},"required":["hook","problem","solution","beats","callToAction"],"additionalProperties":false},"hook":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["enabled","text"],"additionalProperties":false},"cta":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["enabled","text","url"],"additionalProperties":false},"music":{"type":"object","properties":{"source":{"type":"string","enum":["none","library","upload"]},"trackId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uploadUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"gainDb":{"type":"number"},"duck":{"type":"string","enum":["gentle","standard","strong"]}},"required":["source","trackId","uploadUrl","gainDb","duck"],"additionalProperties":false},"smartZoom":{"type":"boolean"},"transitions":{"type":"string","enum":["none","crossfade"]},"portraitLayout":{"type":"string","enum":["split","blur"]},"narrativeTemplate":{"type":"string","enum":["feature_drop","major_release","funding_milestone","product_hunt_launch","changelog","custom"]},"openingStyle":{"type":"string","enum":["end_state_first","cold_open_problem","straight_to_product","brief_intro"]},"heroBeatIdx":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand":{"type":"object","properties":{"colors":{"type":"object","properties":{"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"neutralDark":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"neutralLight":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"warning":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"success":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"required":["primary","accent","neutralDark","neutralLight","warning","success"],"additionalProperties":false},"typography":{"type":"object","properties":{"headlineFont":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z0-9 ,'-]+$"},"headlineFontWeight":{"anyOf":[{"type":"number","const":400},{"type":"number","const":500},{"type":"number","const":600},{"type":"number","const":700},{"type":"number","const":800}]},"bodyFont":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z0-9 ,'-]+$"},"bodyFontWeight":{"anyOf":[{"type":"number","const":400},{"type":"number","const":500},{"type":"number","const":600}]}},"required":["headlineFont","headlineFontWeight","bodyFont","bodyFontWeight"],"additionalProperties":false},"voiceId":{"type":"string"}},"required":["colors","typography","voiceId"],"additionalProperties":false},"voice":{"type":"object","properties":{"attributes":{"type":"object","properties":{"avgSentenceLength":{"type":"number"},"toneRegister":{"type":"string"},"lexicon":{"type":"object","properties":{"lowercaseHooks":{"type":"boolean"},"emDashes":{"type":"string","enum":["frequent","occasional","rare"]},"exclamationMarks":{"type":"string","enum":["frequent","occasional","rare"]},"emoji":{"type":"string","enum":["frequent","occasional","rare"]}},"required":["lowercaseHooks","emDashes","exclamationMarks","emoji"],"additionalProperties":false},"hookPatterns":{"type":"array","items":{"type":"string"}},"endingPatterns":{"type":"array","items":{"type":"string"}},"topicsOfAuthority":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"styleRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rule":{"type":"string"},"llmInstruction":{"type":"string"},"enforced":{"type":"boolean"}},"required":["id","rule","llmInstruction","enforced"],"additionalProperties":false}}},"required":["attributes","styleRules"],"additionalProperties":false}},"required":["outline","hook","cta","music","smartZoom","transitions","portraitLayout","narrativeTemplate","openingStyle","heroBeatIdx","brand","voice"],"additionalProperties":false},"AdvancedScene":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationS":{"type":"number","minimum":0.5,"maximum":60},"narrationText":{"anyOf":[{"type":"string"},{"type":"null"}]},"emotion":{"anyOf":[{"type":"string","enum":["cold_open_pain","onboarding_relief","capable_factual","quiet_wonder","autonomous_action","hands_free_voice","belonging_community","tunable_settings","warm_close"]},{"type":"null"}]},"importance":{"type":"string","enum":["supporting","normal","key"]},"weight":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"kineticText":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"emphasisPhrase":{"anyOf":[{"type":"string"},{"type":"null"}]},"kenBurns":{"type":"string","enum":["none","subtle","strong"]},"motionPlan":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["none","kenburns","spotlight","cursor","callouts","punch_in","static_hold","slow_pan","cursor_sim","scroll_sim"]},"focus":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"steps":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"phrase":{"type":"string"},"label":{"type":"string"},"typing":{"type":"boolean"}},"required":["bbox","phrase"],"additionalProperties":false}},"intent":{"type":"string","enum":["intro","overview","state_change","read_heavy","multi_element","comparison","outcome"]},"easing":{"type":"string","const":"ease_in_out"},"shots":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"framing":{"type":"string","enum":["wide","detail","region"]},"motion":{"type":"string","enum":["none","kenburns","spotlight","cursor","callouts","punch_in","static_hold","slow_pan","cursor_sim","scroll_sim"]},"focus":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"startPhrase":{"type":"string"},"steps":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"phrase":{"type":"string"},"label":{"type":"string"},"typing":{"type":"boolean"}},"required":["bbox","phrase"],"additionalProperties":false}},"minS":{"type":"number","exclusiveMinimum":0},"maxS":{"type":"number","exclusiveMinimum":0},"clipLed":{"type":"boolean"},"startS":{"type":"number","minimum":0},"inputLed":{"type":"boolean"},"label":{"type":"string","maxLength":80}},"required":["framing","motion"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},{"type":"null"}]},"cropRegion":{"anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number","exclusiveMinimum":0},"h":{"type":"number","exclusiveMinimum":0}},"required":["x","y","w","h"],"additionalProperties":false},{"type":"null"}]},"layout":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["full_bleed","device_frame","split","collage","slide"]},"emphasisElementIdx":{"type":"integer","minimum":0,"maximum":9007199254740991},"callouts":{"maxItems":6,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]}},"required":["label","bbox"],"additionalProperties":false}},"panelText":{"type":"string","maxLength":200},"collageImageUrls":{"maxItems":4,"type":"array","items":{"type":"string","format":"uri"}},"source":{"type":"string","enum":["auto","user"]}},"required":["kind","source"],"additionalProperties":false},{"type":"null"}]},"slideSpec":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["flow","chart","comparison","stat","quote","hook","cta"]},"narration":{"type":"string"},"flow":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"required":["id","label"],"additionalProperties":false}},"edges":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false}}},"required":["nodes","edges"],"additionalProperties":false},"chart":{"type":"object","properties":{"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["spec"],"additionalProperties":false},"comparison":{"type":"object","properties":{"before":{"type":"array","items":{"type":"string"}},"after":{"type":"array","items":{"type":"string"}}},"required":["before","after"],"additionalProperties":false},"stat":{"type":"object","properties":{"value":{"type":"string"},"caption":{"type":"string"}},"required":["value","caption"],"additionalProperties":false},"quote":{"type":"object","properties":{"text":{"type":"string"},"attribution":{"type":"string"}},"required":["text"],"additionalProperties":false},"hook":{"type":"object","properties":{"headline":{"type":"string"},"sub":{"type":"string"}},"required":["headline"],"additionalProperties":false},"cta":{"type":"object","properties":{"headline":{"type":"string"},"url":{"type":"string"}},"required":["headline"],"additionalProperties":false}},"required":["kind","narration"],"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"ResolvedPlan":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"intent":{"type":"object","properties":{"artifactType":{"type":"string","enum":["demo_video_landscape","linkedin_carousel","launch_copy"]},"goal":{"type":"string","minLength":1,"maxLength":500},"audience":{"type":"string","enum":["founders","developers","enterprise","consumer","existing_users","waitlist"]},"tone":{"type":"string","enum":["warm","direct","playful","technical","urgent"]},"aspect":{"type":"string","enum":["16:9","9:16","1:1"]},"targetLengthS":{"anyOf":[{"type":"integer","minimum":10,"maximum":600},{"type":"null"}]},"captionStyle":{"type":"string","enum":["karaoke","plain","sparse","off"]},"brandKitId":{"anyOf":[{"type":"string","pattern":"^brk_[0-9a-z]{12}$"},{"type":"null"}]},"voiceProfileId":{"anyOf":[{"type":"string","pattern":"^vp_[0-9a-z]{12}$"},{"type":"null"}]}},"required":["artifactType","goal","audience","tone","aspect","targetLengthS","captionStyle","brandKitId","voiceProfileId"],"additionalProperties":false},"director":{"type":"object","properties":{"outline":{"type":"object","properties":{"hook":{"type":"string"},"problem":{"type":"string"},"solution":{"type":"string"},"beats":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"}},"required":["title"],"additionalProperties":false}},"callToAction":{"type":"string"},"close":{"type":"string"}},"required":["hook","problem","solution","beats","callToAction"],"additionalProperties":false},"hook":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["enabled","text"],"additionalProperties":false},"cta":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["enabled","text","url"],"additionalProperties":false},"music":{"type":"object","properties":{"source":{"type":"string","enum":["none","library","upload"]},"trackId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uploadUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"gainDb":{"type":"number"},"duck":{"type":"string","enum":["gentle","standard","strong"]}},"required":["source","trackId","uploadUrl","gainDb","duck"],"additionalProperties":false},"smartZoom":{"type":"boolean"},"transitions":{"type":"string","enum":["none","crossfade"]},"portraitLayout":{"type":"string","enum":["split","blur"]},"narrativeTemplate":{"type":"string","enum":["feature_drop","major_release","funding_milestone","product_hunt_launch","changelog","custom"]},"openingStyle":{"type":"string","enum":["end_state_first","cold_open_problem","straight_to_product","brief_intro"]},"heroBeatIdx":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand":{"type":"object","properties":{"colors":{"type":"object","properties":{"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"neutralDark":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"neutralLight":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"warning":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"success":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"required":["primary","accent","neutralDark","neutralLight","warning","success"],"additionalProperties":false},"typography":{"type":"object","properties":{"headlineFont":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z0-9 ,'-]+$"},"headlineFontWeight":{"anyOf":[{"type":"number","const":400},{"type":"number","const":500},{"type":"number","const":600},{"type":"number","const":700},{"type":"number","const":800}]},"bodyFont":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z0-9 ,'-]+$"},"bodyFontWeight":{"anyOf":[{"type":"number","const":400},{"type":"number","const":500},{"type":"number","const":600}]}},"required":["headlineFont","headlineFontWeight","bodyFont","bodyFontWeight"],"additionalProperties":false},"voiceId":{"type":"string"}},"required":["colors","typography","voiceId"],"additionalProperties":false},"voice":{"type":"object","properties":{"attributes":{"type":"object","properties":{"avgSentenceLength":{"type":"number"},"toneRegister":{"type":"string"},"lexicon":{"type":"object","properties":{"lowercaseHooks":{"type":"boolean"},"emDashes":{"type":"string","enum":["frequent","occasional","rare"]},"exclamationMarks":{"type":"string","enum":["frequent","occasional","rare"]},"emoji":{"type":"string","enum":["frequent","occasional","rare"]}},"required":["lowercaseHooks","emDashes","exclamationMarks","emoji"],"additionalProperties":false},"hookPatterns":{"type":"array","items":{"type":"string"}},"endingPatterns":{"type":"array","items":{"type":"string"}},"topicsOfAuthority":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"styleRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rule":{"type":"string"},"llmInstruction":{"type":"string"},"enforced":{"type":"boolean"}},"required":["id","rule","llmInstruction","enforced"],"additionalProperties":false}}},"required":["attributes","styleRules"],"additionalProperties":false}},"required":["outline","hook","cta","music","smartZoom","transitions","portraitLayout","narrativeTemplate","openingStyle","heroBeatIdx","brand","voice"],"additionalProperties":false},"scenes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationS":{"type":"number","minimum":0.5,"maximum":60},"narrationText":{"anyOf":[{"type":"string"},{"type":"null"}]},"emotion":{"anyOf":[{"type":"string","enum":["cold_open_pain","onboarding_relief","capable_factual","quiet_wonder","autonomous_action","hands_free_voice","belonging_community","tunable_settings","warm_close"]},{"type":"null"}]},"importance":{"type":"string","enum":["supporting","normal","key"]},"weight":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"kineticText":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"emphasisPhrase":{"anyOf":[{"type":"string"},{"type":"null"}]},"kenBurns":{"type":"string","enum":["none","subtle","strong"]},"motionPlan":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["none","kenburns","spotlight","cursor","callouts","punch_in","static_hold","slow_pan","cursor_sim","scroll_sim"]},"focus":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"steps":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"phrase":{"type":"string"},"label":{"type":"string"},"typing":{"type":"boolean"}},"required":["bbox","phrase"],"additionalProperties":false}},"intent":{"type":"string","enum":["intro","overview","state_change","read_heavy","multi_element","comparison","outcome"]},"easing":{"type":"string","const":"ease_in_out"},"shots":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"framing":{"type":"string","enum":["wide","detail","region"]},"motion":{"type":"string","enum":["none","kenburns","spotlight","cursor","callouts","punch_in","static_hold","slow_pan","cursor_sim","scroll_sim"]},"focus":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"startPhrase":{"type":"string"},"steps":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"phrase":{"type":"string"},"label":{"type":"string"},"typing":{"type":"boolean"}},"required":["bbox","phrase"],"additionalProperties":false}},"minS":{"type":"number","exclusiveMinimum":0},"maxS":{"type":"number","exclusiveMinimum":0},"clipLed":{"type":"boolean"},"startS":{"type":"number","minimum":0},"inputLed":{"type":"boolean"},"label":{"type":"string","maxLength":80}},"required":["framing","motion"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},{"type":"null"}]},"cropRegion":{"anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number","exclusiveMinimum":0},"h":{"type":"number","exclusiveMinimum":0}},"required":["x","y","w","h"],"additionalProperties":false},{"type":"null"}]},"layout":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["full_bleed","device_frame","split","collage","slide"]},"emphasisElementIdx":{"type":"integer","minimum":0,"maximum":9007199254740991},"callouts":{"maxItems":6,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]}},"required":["label","bbox"],"additionalProperties":false}},"panelText":{"type":"string","maxLength":200},"collageImageUrls":{"maxItems":4,"type":"array","items":{"type":"string","format":"uri"}},"source":{"type":"string","enum":["auto","user"]}},"required":["kind","source"],"additionalProperties":false},{"type":"null"}]},"slideSpec":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["flow","chart","comparison","stat","quote","hook","cta"]},"narration":{"type":"string"},"flow":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"required":["id","label"],"additionalProperties":false}},"edges":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false}}},"required":["nodes","edges"],"additionalProperties":false},"chart":{"type":"object","properties":{"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["spec"],"additionalProperties":false},"comparison":{"type":"object","properties":{"before":{"type":"array","items":{"type":"string"}},"after":{"type":"array","items":{"type":"string"}}},"required":["before","after"],"additionalProperties":false},"stat":{"type":"object","properties":{"value":{"type":"string"},"caption":{"type":"string"}},"required":["value","caption"],"additionalProperties":false},"quote":{"type":"object","properties":{"text":{"type":"string"},"attribution":{"type":"string"}},"required":["text"],"additionalProperties":false},"hook":{"type":"object","properties":{"headline":{"type":"string"},"sub":{"type":"string"}},"required":["headline"],"additionalProperties":false},"cta":{"type":"object","properties":{"headline":{"type":"string"},"url":{"type":"string"}},"required":["headline"],"additionalProperties":false}},"required":["kind","narration"],"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"from":{},"to":{}},"required":["field","code","message"],"additionalProperties":false}},"estimate":{"type":"object","properties":{"durationS":{"type":"number"},"costCents":{"type":"number"},"sceneCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ttsChars":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["durationS","costCents","sceneCount","ttsChars"],"additionalProperties":false},"fit":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":1},"reasons":{"type":"array","items":{"type":"string"}},"gaps":{"type":"array","items":{"type":"string"}}},"required":["score","reasons","gaps"],"additionalProperties":false},"previewFrames":{"type":"array","items":{"type":"object","properties":{"sceneId":{"type":"string"},"url":{"type":"string","format":"uri"},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["sceneId","url","width","height"],"additionalProperties":false}},"posterUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"generatedAt":{"type":"string"}},"required":["intent","director","scenes","warnings","estimate","fit","previewFrames","posterUrl","generatedAt"],"additionalProperties":false},"PlanRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"intent":{"type":"object","properties":{"artifactType":{"type":"string","enum":["demo_video_landscape","linkedin_carousel","launch_copy"]},"goal":{"type":"string","minLength":1,"maxLength":500},"audience":{"type":"string","enum":["founders","developers","enterprise","consumer","existing_users","waitlist"]},"tone":{"type":"string","enum":["warm","direct","playful","technical","urgent"]},"aspect":{"type":"string","enum":["16:9","9:16","1:1"]},"targetLengthS":{"anyOf":[{"type":"integer","minimum":10,"maximum":600},{"type":"null"}]},"captionStyle":{"type":"string","enum":["karaoke","plain","sparse","off"]},"brandKitId":{"anyOf":[{"type":"string","pattern":"^brk_[0-9a-z]{12}$"},{"type":"null"}]},"voiceProfileId":{"anyOf":[{"type":"string","pattern":"^vp_[0-9a-z]{12}$"},{"type":"null"}]}},"additionalProperties":false},"director":{"type":"object","properties":{"outline":{"type":"object","properties":{"hook":{"type":"string"},"problem":{"type":"string"},"solution":{"type":"string"},"beats":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"}},"required":["title"],"additionalProperties":false}},"callToAction":{"type":"string"},"close":{"type":"string"}},"additionalProperties":false},"hook":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"cta":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"additionalProperties":false},"music":{"type":"object","properties":{"source":{"type":"string","enum":["none","library","upload"]},"trackId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uploadUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"gainDb":{"type":"number"},"duck":{"type":"string","enum":["gentle","standard","strong"]}},"additionalProperties":false},"smartZoom":{"type":"boolean"},"transitions":{"type":"string","enum":["none","crossfade"]},"portraitLayout":{"type":"string","enum":["split","blur"]},"narrativeTemplate":{"type":"string","enum":["feature_drop","major_release","funding_milestone","product_hunt_launch","changelog","custom"]},"openingStyle":{"type":"string","enum":["end_state_first","cold_open_problem","straight_to_product","brief_intro"]},"heroBeatIdx":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand":{"type":"object","properties":{"colors":{"type":"object","properties":{"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"neutralDark":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"neutralLight":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"warning":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"success":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"required":["primary","accent","neutralDark","neutralLight","warning","success"],"additionalProperties":false},"typography":{"type":"object","properties":{"headlineFont":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z0-9 ,'-]+$"},"headlineFontWeight":{"anyOf":[{"type":"number","const":400},{"type":"number","const":500},{"type":"number","const":600},{"type":"number","const":700},{"type":"number","const":800}]},"bodyFont":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z0-9 ,'-]+$"},"bodyFontWeight":{"anyOf":[{"type":"number","const":400},{"type":"number","const":500},{"type":"number","const":600}]}},"required":["headlineFont","headlineFontWeight","bodyFont","bodyFontWeight"],"additionalProperties":false},"voiceId":{"type":"string"}},"additionalProperties":false},"voice":{"type":"object","properties":{"attributes":{"type":"object","properties":{"avgSentenceLength":{"type":"number"},"toneRegister":{"type":"string"},"lexicon":{"type":"object","properties":{"lowercaseHooks":{"type":"boolean"},"emDashes":{"type":"string","enum":["frequent","occasional","rare"]},"exclamationMarks":{"type":"string","enum":["frequent","occasional","rare"]},"emoji":{"type":"string","enum":["frequent","occasional","rare"]}},"required":["lowercaseHooks","emDashes","exclamationMarks","emoji"],"additionalProperties":false},"hookPatterns":{"type":"array","items":{"type":"string"}},"endingPatterns":{"type":"array","items":{"type":"string"}},"topicsOfAuthority":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"styleRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rule":{"type":"string"},"llmInstruction":{"type":"string"},"enforced":{"type":"boolean"}},"required":["id","rule","llmInstruction","enforced"],"additionalProperties":false}}},"additionalProperties":false}},"additionalProperties":false},"scenes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationS":{"type":"number","minimum":0.5,"maximum":60},"narrationText":{"anyOf":[{"type":"string"},{"type":"null"}]},"emotion":{"anyOf":[{"type":"string","enum":["cold_open_pain","onboarding_relief","capable_factual","quiet_wonder","autonomous_action","hands_free_voice","belonging_community","tunable_settings","warm_close"]},{"type":"null"}]},"importance":{"type":"string","enum":["supporting","normal","key"]},"weight":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"kineticText":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"emphasisPhrase":{"anyOf":[{"type":"string"},{"type":"null"}]},"kenBurns":{"type":"string","enum":["none","subtle","strong"]},"motionPlan":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["none","kenburns","spotlight","cursor","callouts","punch_in","static_hold","slow_pan","cursor_sim","scroll_sim"]},"focus":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"steps":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"phrase":{"type":"string"},"label":{"type":"string"},"typing":{"type":"boolean"}},"required":["bbox","phrase"],"additionalProperties":false}},"intent":{"type":"string","enum":["intro","overview","state_change","read_heavy","multi_element","comparison","outcome"]},"easing":{"type":"string","const":"ease_in_out"},"shots":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"framing":{"type":"string","enum":["wide","detail","region"]},"motion":{"type":"string","enum":["none","kenburns","spotlight","cursor","callouts","punch_in","static_hold","slow_pan","cursor_sim","scroll_sim"]},"focus":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"startPhrase":{"type":"string"},"steps":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]},"phrase":{"type":"string"},"label":{"type":"string"},"typing":{"type":"boolean"}},"required":["bbox","phrase"],"additionalProperties":false}},"minS":{"type":"number","exclusiveMinimum":0},"maxS":{"type":"number","exclusiveMinimum":0},"clipLed":{"type":"boolean"},"startS":{"type":"number","minimum":0},"inputLed":{"type":"boolean"},"label":{"type":"string","maxLength":80}},"required":["framing","motion"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},{"type":"null"}]},"cropRegion":{"anyOf":[{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"w":{"type":"number","exclusiveMinimum":0},"h":{"type":"number","exclusiveMinimum":0}},"required":["x","y","w","h"],"additionalProperties":false},{"type":"null"}]},"layout":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["full_bleed","device_frame","split","collage","slide"]},"emphasisElementIdx":{"type":"integer","minimum":0,"maximum":9007199254740991},"callouts":{"maxItems":6,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}]}},"required":["label","bbox"],"additionalProperties":false}},"panelText":{"type":"string","maxLength":200},"collageImageUrls":{"maxItems":4,"type":"array","items":{"type":"string","format":"uri"}},"source":{"type":"string","enum":["auto","user"]}},"required":["kind","source"],"additionalProperties":false},{"type":"null"}]},"slideSpec":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["flow","chart","comparison","stat","quote","hook","cta"]},"narration":{"type":"string"},"flow":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"required":["id","label"],"additionalProperties":false}},"edges":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false}}},"required":["nodes","edges"],"additionalProperties":false},"chart":{"type":"object","properties":{"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["spec"],"additionalProperties":false},"comparison":{"type":"object","properties":{"before":{"type":"array","items":{"type":"string"}},"after":{"type":"array","items":{"type":"string"}}},"required":["before","after"],"additionalProperties":false},"stat":{"type":"object","properties":{"value":{"type":"string"},"caption":{"type":"string"}},"required":["value","caption"],"additionalProperties":false},"quote":{"type":"object","properties":{"text":{"type":"string"},"attribution":{"type":"string"}},"required":["text"],"additionalProperties":false},"hook":{"type":"object","properties":{"headline":{"type":"string"},"sub":{"type":"string"}},"required":["headline"],"additionalProperties":false},"cta":{"type":"object","properties":{"headline":{"type":"string"},"url":{"type":"string"}},"required":["headline"],"additionalProperties":false}},"required":["kind","narration"],"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},"CreateProjectBody":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"goal":{"type":"string","minLength":1,"maxLength":500},"intent":{"type":"object","properties":{"artifactType":{"type":"string","enum":["demo_video_landscape","linkedin_carousel","launch_copy"]},"goal":{"type":"string","minLength":1,"maxLength":500},"audience":{"type":"string","enum":["founders","developers","enterprise","consumer","existing_users","waitlist"]},"tone":{"type":"string","enum":["warm","direct","playful","technical","urgent"]},"aspect":{"type":"string","enum":["16:9","9:16","1:1"]},"targetLengthS":{"anyOf":[{"type":"integer","minimum":10,"maximum":600},{"type":"null"}]},"captionStyle":{"type":"string","enum":["karaoke","plain","sparse","off"]},"brandKitId":{"anyOf":[{"type":"string","pattern":"^brk_[0-9a-z]{12}$"},{"type":"null"}]},"voiceProfileId":{"anyOf":[{"type":"string","pattern":"^vp_[0-9a-z]{12}$"},{"type":"null"}]}},"additionalProperties":false},"features":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"screenshots":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"contentType":{"type":"string"},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":10485760},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["contentType","sizeBytes"],"additionalProperties":false}}},"required":["name","screenshots"],"additionalProperties":false}}},"required":["goal"],"additionalProperties":false},"RegenerateArtifactBody":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"scope":{"type":"string","enum":["scene","audio","video","slide","caption","whole"]},"targetId":{"type":"string","minLength":1},"videoConfig":{"type":"object","properties":{"aspect":{"default":"16:9","type":"string","enum":["16:9","9:16","1:1"]},"captions":{"default":{"style":"sparse"},"type":"object","properties":{"style":{"default":"sparse","type":"string","enum":["karaoke","plain","sparse","off"]}},"required":["style"],"additionalProperties":false},"portraitLayout":{"default":"split","type":"string","enum":["split","blur"]},"hook":{"default":{"enabled":true,"text":null},"type":"object","properties":{"enabled":{"default":true,"type":"boolean"},"text":{"default":null,"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]}},"required":["enabled","text"],"additionalProperties":false},"cta":{"default":{"enabled":true,"text":null,"url":null},"type":"object","properties":{"enabled":{"default":true,"type":"boolean"},"text":{"default":null,"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"url":{"default":null,"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["enabled","text","url"],"additionalProperties":false},"music":{"default":{"source":"none","trackId":null,"uploadUrl":null,"gainDb":-18,"duck":"standard"},"type":"object","properties":{"source":{"default":"none","type":"string","enum":["none","library","upload"]},"trackId":{"default":null,"anyOf":[{"type":"string"},{"type":"null"}]},"uploadUrl":{"default":null,"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"gainDb":{"default":-18,"type":"number","minimum":-40,"maximum":0},"duck":{"default":"standard","type":"string","enum":["gentle","standard","strong"]}},"required":["source","trackId","uploadUrl","gainDb","duck"],"additionalProperties":false},"smartZoom":{"default":true,"type":"boolean"},"transitions":{"default":"crossfade","type":"string","enum":["none","crossfade"]},"resolution":{"default":"1080p","type":"string","enum":["1080p","1440p","2160p"]}},"required":["aspect","captions","portraitLayout","hook","cta","music","smartZoom","transitions","resolution"],"additionalProperties":false}},"required":["scope"],"additionalProperties":false},"ComposeRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":600}},"required":["message"],"additionalProperties":false},"ComposeResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"stage":{"type":"string","enum":["plan","tweak"]},"reply":{"type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"ops":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"setField"},"sceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},"field":{"type":"string","enum":["narrationText","emotion","kineticText","caption","emphasisPhrase","kenBurns","cropRegion","motionFocus","durationS","importance","weight","clipTrim"]},"value":{}},"required":["kind","sceneId","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"reorder"},"sceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},"position":{"type":"string","enum":["before","after"]},"refSceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"}},"required":["kind","sceneId","position","refSceneId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"insertSlide"},"afterSceneId":{"anyOf":[{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},{"type":"null"}]},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["kind","afterSceneId","spec"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"deleteScene"},"sceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"}},"required":["kind","sceneId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setVoice"},"voiceProfileId":{"type":"string"}},"required":["kind","voiceProfileId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setVideoConfig"},"patch":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["kind","patch"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"recapture"},"sceneId":{"anyOf":[{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"instruction":{"type":"string","maxLength":400}},"required":["kind","sceneId","url","instruction"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setOutlineField"},"field":{"type":"string","enum":["hook","problem","solution","callToAction","close"]},"value":{"type":"string","minLength":1,"maxLength":600}},"required":["kind","field","value"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"audience"},"value":{"type":"string","enum":["founders","developers","enterprise","consumer","existing_users","waitlist"]}},"required":["kind","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"tone"},"value":{"type":"string","enum":["warm","direct","playful","technical","urgent"]}},"required":["kind","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"narrativeTemplate"},"value":{"type":"string","enum":["feature_drop","major_release","funding_milestone","product_hunt_launch","changelog","custom"]}},"required":["kind","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"targetLengthS"},"value":{"type":"integer","minimum":15,"maximum":300}},"required":["kind","field","value"],"additionalProperties":false}]}]}},"opCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scope":{"type":"string","enum":["plan","scene","caption","audio","video","slide","whole"]},"clarify":{"anyOf":[{"type":"object","properties":{"question":{"type":"string"},"options":{"maxItems":4,"type":"array","items":{"type":"string"}}},"required":["question","options"],"additionalProperties":false},{"type":"null"}]},"turn":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["stage","reply","summary","ops","opCount","scope","clarify","turn"],"additionalProperties":false},"ApplyRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ops":{"maxItems":40,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"setField"},"sceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},"field":{"type":"string","enum":["narrationText","emotion","kineticText","caption","emphasisPhrase","kenBurns","cropRegion","motionFocus","durationS","importance","weight","clipTrim"]},"value":{}},"required":["kind","sceneId","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"reorder"},"sceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},"position":{"type":"string","enum":["before","after"]},"refSceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"}},"required":["kind","sceneId","position","refSceneId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"insertSlide"},"afterSceneId":{"anyOf":[{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},{"type":"null"}]},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["kind","afterSceneId","spec"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"deleteScene"},"sceneId":{"type":"string","pattern":"^scn_[0-9a-z]{12}$"}},"required":["kind","sceneId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setVoice"},"voiceProfileId":{"type":"string"}},"required":["kind","voiceProfileId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setVideoConfig"},"patch":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["kind","patch"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"recapture"},"sceneId":{"anyOf":[{"type":"string","pattern":"^scn_[0-9a-z]{12}$"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"instruction":{"type":"string","maxLength":400}},"required":["kind","sceneId","url","instruction"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setOutlineField"},"field":{"type":"string","enum":["hook","problem","solution","callToAction","close"]},"value":{"type":"string","minLength":1,"maxLength":600}},"required":["kind","field","value"],"additionalProperties":false},{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"audience"},"value":{"type":"string","enum":["founders","developers","enterprise","consumer","existing_users","waitlist"]}},"required":["kind","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"tone"},"value":{"type":"string","enum":["warm","direct","playful","technical","urgent"]}},"required":["kind","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"narrativeTemplate"},"value":{"type":"string","enum":["feature_drop","major_release","funding_milestone","product_hunt_launch","changelog","custom"]}},"required":["kind","field","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"setProjectMeta"},"field":{"type":"string","const":"targetLengthS"},"value":{"type":"integer","minimum":15,"maximum":300}},"required":["kind","field","value"],"additionalProperties":false}]}]}}},"required":["ops"],"additionalProperties":false},"ApplyResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"applied":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unsupported":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"reason":{"type":"string"}},"required":["kind","reason"],"additionalProperties":false}},"render":{"anyOf":[{"type":"object","properties":{"artifactId":{"type":"string"},"scope":{"type":"string"},"targetSceneIds":{"type":"array","items":{"type":"string"}}},"required":["artifactId","scope","targetSceneIds"],"additionalProperties":false},{"type":"null"}]},"ceilingBlocked":{"type":"boolean"}},"required":["ok","applied","unsupported","render","ceilingBlocked"],"additionalProperties":false},"ApiKeyPublic":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"keyPrefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["plan","render"]}},"spendCapCents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rateLimitPerMin":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastUsedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["id","name","keyPrefix","scopes","spendCapCents","rateLimitPerMin","lastUsedAt","revokedAt","createdAt"],"additionalProperties":false},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}},"security":[{"bearerAuth":[]}],"paths":{"/v1/health":{"get":{"summary":"Liveness + auth probe","responses":{"200":{"description":"OK"}}}},"/v1/projects":{"post":{"summary":"Create a project from a goal + screenshot folders","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProjectBody"}}}},"responses":{"201":{"description":"Project + presigned uploads"},"402":{"description":"Quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/projects/{id}/screenshots":{"post":{"summary":"Add screenshots to a project","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Presigned uploads"}}}},"/v1/projects/{id}/plan":{"post":{"summary":"Run the director without rendering → a resolved plan","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanRequest"}}}},"responses":{"200":{"description":"A fully-resolved plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvedPlan"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"summary":"The last persisted plan","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A fully-resolved plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvedPlan"}}}},"404":{"description":"No plan yet","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/projects/{id}/render":{"post":{"summary":"Commit a plan → fork a variant + enqueue a render","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanRequest"}}}},"responses":{"202":{"description":"Render accepted (renderId, variantProjectId)"},"402":{"description":"Quota/spend","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/projects/{id}/variants":{"get":{"summary":"List a project's render variants (forked by render)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Variants"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/projects/{id}/compose":{"post":{"summary":"One composer turn: natural language → proposed EditPlan ops (never auto-applies)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComposeRequest"}}}},"responses":{"200":{"description":"The proposed turn (reply, ops, scope, clarify)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComposeResponse"}}}},"402":{"description":"Spend cap / cost ceiling","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/projects/{id}/ops/apply":{"post":{"summary":"Apply EditPlan ops; render-tier ops enqueue the scoped re-render (render scope)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyRequest"}}}},"responses":{"200":{"description":"What applied + the enqueued re-render (or null)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyResponse"}}}},"402":{"description":"Spend cap","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Key lacks the render scope for a render-spending apply","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/artifacts/{id}/regenerate":{"post":{"summary":"Scoped regenerate (whole|scene|audio|video|caption)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegenerateArtifactBody"}}}},"responses":{"200":{"description":"Updated artifact"},"402":{"description":"Spend cap","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/renders/{id}":{"get":{"summary":"Machine-readable render result (any status)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Render result"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/renders/{id}/events":{"get":{"summary":"SSE relay of render progress","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"text/event-stream"}}}},"/v1/openapi.json":{"get":{"summary":"This document","security":[],"responses":{"200":{"description":"OpenAPI 3.1"}}}}}}