{"uid":"cap_fH6ZXPhagN8sk4Qz9HHgt","slug":"halowerk-medien-scene-detection-132f6ee3","name":"halowerk Medien Scene Detection","description":"HALOWERK medienwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.","url":"https://medien.halowerk.com/v1/keyframes?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"source":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"description":"Public http(s) URL of the video."},"filename":{"type":"string","maxLength":260},"content_base64":{"type":"string","maxLength":12000000,"description":"The video inline, base64. Larger files must come by url."}},"description":"The video. Either url or content_base64.","additionalProperties":false},"max_scenes":{"type":"integer","default":100,"maximum":400,"minimum":1,"description":"Ceiling on returned scenes. What is dropped is counted and reported."},"max_thumbnails":{"type":"integer","default":20,"maximum":60,"minimum":1,"description":"Ceiling on rendered thumbnails, independent of the scene count."},"scene_threshold":{"type":"number","default":0.35,"maximum":0.95,"minimum":0.05,"description":"Frame-to-frame difference above which a new scene starts. Lower finds more, higher finds fewer."},"thumbnail_width":{"type":"integer","default":160,"maximum":640,"minimum":32,"description":"Width of the thumbnails; height follows the aspect ratio."},"duration_minutes":{"type":"integer","default":1,"maximum":30,"minimum":1,"description":"Length of the video in started minutes — this is what you are billed for. A longer video is refused with its real duration and nothing is charged; a shorter one simply costs what you declared, and the answer says how much less it would have been."},"min_scene_seconds":{"type":"number","default":0.4,"maximum":60,"minimum":0,"description":"Merge cuts closer together than this. Guards against flicker being read as a cut."},"include_thumbnails":{"type":"boolean","default":false,"description":"Render one JPEG per scene and return it base64."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rvHKPQdJGWgZSavHsWwyk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a video (by URL or base64) using FFmpeg frame-difference analysis to detect scene boundaries and return timestamps, durations, and detection scores for each scene.","exampleAgentPrompt":"Can you detect all the scene changes in this video — https://example.com/myvideo.mp4 — and tell me when each scene starts and ends, how long it lasts, and what fraction of the total runtime it covers?","exampleUseCases":[{"title":"Chapter markers for video editor","prompt":"I'm editing a long interview video at https://cdn.example.com/interview.mp4 — can you find every scene cut and give me the start and end timestamps for each scene so I can use them as chapter markers?"},{"title":"Automated highlight reel segmentation","prompt":"Here's a sports broadcast clip as a base64 video. Detect all the scene changes and tell me the duration and fraction of total runtime for each segment so I can pick the longest continuous scenes for a highlight reel."},{"title":"Quality check for ad-break detection","prompt":"I need to verify where the scene transitions happen in this commercial video at https://media.example.com/ad_spot.mp4 — can you run scene detection and give me the raw detection scores and cut positions?"}],"resultDescription":"A list of detected scenes, each with its start time, end time, duration, fraction of total video runtime, and raw FFmpeg frame-difference detection score at that boundary point.","failureModes":["Video URL is inaccessible or returns a non-200 response","Base64 payload is malformed or not a valid video format","Video is too short or has no detectable scene changes — returns empty scene list","Threshold parameter set too high causing all cuts to be missed","Threshold parameter set too low causing noise to be detected as scenes","Unsupported video codec or container format","Network timeout for large remote video files"],"whenToPreferThis":"Choose this endpoint when you need timestamped scene boundary data from a video, especially when you want FFmpeg-level precision with raw detection scores. Prefer this over manual frame extraction when you need the full list of scene segments with duration fractions in a single call. Best suited for workflows that chapter-mark, summarize, or segment video content automatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T11:35:04.693Z","isFirstParty":false,"canonicalSlug":"halowerk-medien-scene-detection-132f6ee3"}