{"slug":"video-api-williamrobinson-dev-v1-video-finish-21d235","title":"Finish a short source video (<=60s, <=1080p, <=64MB, fetched by URL) into up to ","host":"video.api.williamrobinson.dev","method":"POST","resource":"https://video.api.williamrobinson.dev/v1/video/finish","category":"image","description":"Finish a short source video (<=60s, <=1080p, <=64MB, fetched by URL) into up to two platform-preset deliverables: caller-guided crop reframing between declared subject regions (never automatic detection), sidecar or burned-in subtitles with reflow, and EBU R128 loudness normalised to the preset targ","price_listed":0.5,"price_asked":0.5,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":612,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"brand":null,"deliverables":[{"captions":"burned","language":"en","preset":"youtube-16x9","sidecar":true},{"captions":"none","language":null,"preset":"shorts-9x16","sidecar":false}],"options":{"captionFontSizeFraction":0.045,"captionMaxCharsPerLine":42,"captionMaxLines":2,"normalizeLoudness":true},"sourceUrl":"https://interactive-examples.mdn.mozilla.net/media/cc0-videos/friday.mp4","subjects":[{"box":{"h":0.6,"w":0.35,"x":0.325,"y":0.2},"fromS":0,"toS":6}],"subtitles":[{"content":"1\n00:00:00,000 --> 00:00:02,000\nFriday afternoon at the switchboard\n\n2\n00:00:02,000 --> 00:00:04,000\nThe operators keep the calls moving\n\n3\n00:00:04,000 --> 00:00:06,000\nA vintage office comedy short\n","format":"srt","language":"en"}]},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"brand":{"additionalProperties":false,"properties":{"logoPng":{"contentEncoding":"base64","description":"Base64 PNG (<= 262144 bytes decoded), or null.","maxLength":349528,"type":["string","null"]},"position":{"enum":["top-left","top-right","bottom-left","bottom-right"],"type":"string"},"widthFraction":{"description":"Logo width as a fraction of output width.","maximum":0.3,"minimum":0.05,"type":"number"}},"required":["logoPng","position","widthFraction"],"type":["object","null"]},"deliverables":{"items":{"additionalProperties":false,"properties":{"captions":{"enum":["burned","sidecar","none"],"type":"string"},"language":{"description":"Must reference a subtitles[] language when captions is not \"none\"; must be null when captions is \"none\".","type":["string","null"]},"preset":{"enum":["youtube-16x9","shorts-9x16","reels-9x16","tiktok-9x16","square-1x1","feed-4x5"],"type":"string"},"sidecar":{"description":"Also produce the sidecar .vtt when captions is \"burned\".","type":"boolean"}},"required":["preset","language","captions","sidecar"],"type":"object"},"maxItems":2,"minItems":1,"type":"array"},"options":{"additionalProperties":false,"properties":{"captionFontSizeFraction":{"default":0.045,"maximum":0.12,"minimum":0.02,"type":"number"},"captionMaxCharsPerLine":{"default":42,"maximum":80,"minimum":10,"type":"integer"},"captionMaxLines":{"default":2,"maximum":4,"minimum":1,"type":"integer"},"normalizeLoudness":{"default":true,"type":"boolean"}},"type":"object"},"sourceUrl":{"description":"Public HTTPS URL of the source video (mp4/mov/webm/mkv, <= 67108864 bytes, <= 60s, <= 1080p). Fetched by the service before processing.","format":"uri","maxLength":2048,"type":"string"},"subjects":{"description":"Regions of interest the reframer must keep in view; empty means centre-crop.","items":{"additionalProperties":false,"properties":{"box":{"additionalProperties":false,"description":"Region of interest in source-pixel fractions.","properties":{"h":{"exclusiveMinimum":0,"maximum":1,"type":"number"},"w":{"exclusiveMinimum":0,"maximum":1,"type":"number"},"x":{"maximum":1,"minimum":0,"type":"number"},"y":{"maximum":1,"minimum":0,"type":"number"}},"required":["x","y","w","h"],"type":"object"},"fromS":{"maximum":60,"minimum":0,"type":"number"},"toS":{"description":"Must be greater than fromS.","maximum":60,"minimum":0,"type":"number"}},"required":["fromS","toS","box"],"type":"object"},"maxItems":20,"type":"array"},"subtitles":{"items":{"additionalProperties":false,"properties":{"content":{"description":"Subtitle file contents (UTF-8 bytes capped, not characters).","maxLength":131072,"minLength":1,"type":"string"},"format":{"enum":["srt","vtt"],"type":"string"},"language":{"description":"BCP-47-style language tag, e.g. \"en\" or \"pt-BR\"; unique across subtitles.","pattern":"^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$","type":"string"}},"required":["language","format","content"],"type":"object"},"maxItems":6,"type":"array"}},"required":["sourceUrl","subtitles","subjects","brand","deliverables","options"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"$defs":{"artifact":{"additionalProperties":false,"properties":{"href":{"format":"uri","type":"string"},"mediaType":{"type":"string"},"name":{"enum":["deliverable-1.mp4","deliverable-1.vtt","deliverable-2.mp4","deliverable-2.vtt","contact-sheet.png","qc.json","report.json"],"type":"string"},"sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"sizeBytes":{"minimum":0,"type":"integer"}},"required":["name","mediaType","sizeBytes","sha256","href"],"type":"object"},"captionStats":{"additionalProperties":false,"properties":{"cues":{"minimum":0,"type":"integer"},"overlapsFixed":{"minimum":0,"type":"integer"},"reflowedCues":{"minimum":0,"type":"integer"},"shortCues":{"minimum":0,"type":"integer"}},"required":["cues","reflowedCues","overlapsFixed","shortCues"],"type":"object"},"loudness":{"additionalProperties":false,"properties":{"integratedLufs":{"type":"number"},"rangeLu":{"minimum":0,"type":"number"},"truePeakDbtp":{"type":"number"}},"required":["integratedLufs","rangeLu","truePeakDbtp"],"type":"object"},"presetSpec":{"additionalProperties":false,"properties":{"aspect":{"enum":["16:9","9:16","1:1","4:5"],"type":"string"},"audioBitrateKbps":{"exclusiveMinimum":0,"type":"number"},"height":{"minimum":1,"type":"integer"},"loudnessLufs":{"type":"number"},"maxFps":{"exclusiveMinimum":0,"type":"number"},"safeMargin":{"maximum":1,"minimum":0,"type":"number"},"truePeakDbtp":{"type":"number"},"videoBitrateKbps":{"exclusiveMinimum":0,"type":"number"},"width":{"minimum":1,"type":"integer"}},"required":["aspect","width","height","maxFps","loudnessLufs","truePeakDbtp","videoBitrateKbps","audioBitrateKbps","safeMargin"],"type":"object"},"reframeWindow":{"additionalProperties":false,"properties":{"fromS":{"minimum":0,"type":"number"},"h":{"exclusiveMinimum":0,"type":"integer"},"toS":{"minimum":0,"type":"number"},"w":{"exclusiveMinimum":0,"type":"integer"},"x":{"minimum":0,"type":"integer"},"y":{"minimum":0,"type":"integer"}},"required":["fromS","toS","x","y","w","h"],"type":"object"},"streamInfo":{"additionalProperties":false,"properties":{"audioChannels":{"minimum":0,"type":["integer","null"]},"audioCodec":{"type":["string","null"]},"bitrateKbps":{"minimum":0,"type":"number"},"bytes":{"minimum":0,"type":"integer"},"container":{"type":"string"},"durationS":{"minimum":0,"type":"number"},"fps":{"exclusiveMinimum":0,"type":"number"},"height":{"minimum":1,"type":"integer"},"sampleRate":{"minimum":0,"type":["integer","null"]},"videoCodec":{"type":"string"},"width":{"minimum":1,"type":"integer"}},"required":["container","videoCodec","width","height","fps","durationS","audioCodec","audioChannels","sampleRate","bitrateKbps","bytes"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"artifacts":{"items":{"$ref":"#/properties/output/properties/example/$defs/artifact"},"maxItems":7,"type":"array"},"checks":{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"detail":{"type":"string"},"status":{"enum":["passed","failed","not_checked"],"type":"string"}},"required":["code","status","detail"],"type":"object"},"type":"array"},"deliverables":{"items":{"additionalProperties":false,"properties":{"captionStats":{"anyOf":[{"$ref":"#/properties/output/properties/example/$defs/captionStats"},{"type":"null"}]},"captions":{"enum":["burned","sidecar","none"],"type":"string"},"detail":{"type":"string"},"encodeMs":{"minimum":0,"type":"number"},"language":{"type":["string","null"]},"loudness":{"anyOf":[{"$ref":"#/properties/output/properties/example/$defs/loudness"},{"type":"null"}]},"output":{"anyOf":[{"$ref":"#/properties/output/properties/example/$defs/streamInfo"},{"type":"null"}]},"preset":{"enum":["youtube-16x9","shorts-9x16","reels-9x16","tiktok-9x16","square-1x1","feed-4x5"],"type":"string"},"reframe":{"items":{"$ref":"#/properties/output/properties/example/$defs/reframeWindow"},"type":"array"},"slot":{"enum":["deliverable-1","deliverable-2"],"type":"string"},"spec":{"$ref":"#/properties/output/properties/example/$defs/presetSpec"},"status":{"enum":["generated","failed"],"type":"string"}},"required":["slot","preset","spec","language","captions","status","detail","output","loudness","reframe","captionStats","encodeMs"],"type":"object"},"maxItems":2,"type":"array"},"expiresAt":{"format":"date-time","type":"string"},"limitations":{"items":{"type":"string"},"maxItems":100,"type":"array"},"qc":{"additionalProperties":false,"properties":{"blackSegments":{"items":{"additionalProperties":false,"properties":{"fromS":{"minimum":0,"type":"number"},"toS":{"minimum":0,"type":"number"}},"required":["fromS","toS"],"type":"object"},"maxItems":100,"type":"array"},"frozenSegments":{"items":{"additionalProperties":false,"properties":{"fromS":{"minimum":0,"type":"number"},"toS":{"minimum":0,"type":"number"}},"required":["fromS","toS"],"type":"object"},"maxItems":100,"type":"array"},"silentSegments":{"items":{"additionalProperties":false,"properties":{"fromS":{"minimum":0,"type":"number"},"toS":{"minimum":0,"type":"number"}},"required":["fromS","toS"],"type":"object"},"maxItems":100,"type":"array"},"subtitleIssues":{"items":{"additionalProperties":false,"properties":{"code":{"type":"string"},"cue":{"minimum":0,"type":"integer"},"detail":{"type":"string"},"language":{"type":"string"}},"required":["language","cue","code","detail"],"type":"object"},"maxItems":100,"type":"array"}},"required":["blackSegments","frozenSegments","silentSegments","subtitleIssues"],"type":"object"},"source":{"additionalProperties":false,"properties":{"audioChannels":{"minimum":0,"type":["integer","null"]},"audioCodec":{"type":["string","null"]},"bitrateKbps":{"minimum":0,"type":"number"},"bytes":{"minimum":0,"type":"integer"},"container":{"type":"string"},"durationS":{"minimum":0,"type":"number"},"fps":{"exclusiveMinimum":0,"type":"number"},"height":{"minimum":1,"type":"integer"},"loudness":{"anyOf":[{"$ref":"#/properties/output/properties/example/$defs/loudness"},{"type":"null"}]},"sampleRate":{"minimum":0,"type":["integer","null"]},"sha256":{"pattern":"^[a-f0-9]{64}$","type":"string"},"url":{"type":"string"},"videoCodec":{"type":"string"},"width":{"minimum":1,"type":"integer"}},"required":["container","videoCodec","width","height","fps","durationS","audioCodec","audioChannels","sampleRate","bitrateKbps","bytes","url","sha256","loudness"],"type":"object"},"status":{"enum":["passed","failed"],"type":"string"},"tools":{"additionalProperties":false,"properties":{"ffmpeg":{"type":"string"},"runner":{"type":"string"}},"required":["ffmpeg","runner"],"type":"object"},"truncated":{"type":"boolean"},"warnings":{"items":{"type":"string"},"maxItems":100,"type":"array"}},"required":["status","tools","source","deliverables","qc","checks","warnings","limitations","truncated","expiresAt","artifacts"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.5,"price_match":true,"latency_ms":612,"error":null}],"description_full":"Finish a short source video (<=60s, <=1080p, <=64MB, fetched by URL) into up to two platform-preset deliverables: caller-guided crop reframing between declared subject regions (never automatic detection), sidecar or burned-in subtitles with reflow, and EBU R128 loudness normalised to the preset target and measured, never claimed compliant. Includes a contact sheet. No rights clearance performed.","last_updated":"2026-09-11T20:08:09.794Z","schemes":["exact"]}