{"uid":"cap_BSbQeWZcn-DndThysQDhY","slug":"ytclip-modestpika-box-ca-ytclip-single-media-clip-finder-and-cutter-6ed4064e","name":"YTClip Single Media Clip Finder and Cutter","description":"Find and cut a single clip from a media URL matching a natural-language query.","url":"https://ytclip.modestpika.box.ca/clip?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["media_url","query"],"properties":{"query":{"type":"string","example":"the part where she says I don't have online","minLength":1,"description":"Natural-language description of the moment to clip."},"media_url":{"type":"string","format":"uri","example":"https://www.youtube.com/watch?v=jK-ZRxeJIiU","description":"Source media URL — anything yt-dlp accepts (YouTube, Twitch VOD, podcast mp3, direct mp4, etc.)"},"max_clip_seconds":{"type":"integer","default":60,"maximum":600,"minimum":1,"description":"Hard cap on clip length; matched span is trimmed around its center if it exceeds this."}}},"responseSchema":{"type":"object","required":["clip_url","start","end","transcript","reasoning","cached"],"properties":{"end":{"type":"number","description":"Clip end within the source, in seconds."},"start":{"type":"number","description":"Clip start within the source, in seconds."},"cached":{"type":"object","properties":{"clip":{"type":"boolean"},"source":{"type":"boolean"},"transcript":{"type":"boolean"}}},"clip_url":{"type":"string","format":"uri","description":"Public URL of the cut mp4."},"reasoning":{"type":"string","description":"One-sentence explanation from the LLM."},"transcript":{"type":"string","description":"Transcript text covered by the clip."}}},"example":{"request":{"query":"the chorus section","media_url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","max_clip_seconds":60},"response":{"end":59.42,"start":42.66,"cached":{"clip":false,"source":false,"transcript":false},"clip_url":"https://ytclip.modestpika.box.ca/clips/6e53672f675b91a4.mp4","reasoning":"The chorus section is identified by the repetition of the phrase 'Never gonna' in segments 7 to 12, which is a common lyrical pattern in song choruses.","transcript":"Never gonna give you up Never gonna let you down Never gonna run around and desert you Never gonna make you cry Never gonna say goodbye Never gonna tell a lie and hurt you"}},"exampleRequest":{"query":"the chorus section","media_url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","max_clip_seconds":60},"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.67","reviews":1,"stars":null,"state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e1pxBtIQV36EE31HN5jkq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"ytclip.modestpika.box.ca","brandSlug":"ytclip-modestpika-box-ca-x402","brandBaseUrl":"https://ytclip.modestpika.box.ca","brandDocsUrl":null,"whatItDoes":"Finds a moment in a media URL matching a natural-language query and returns a cut mp4 clip of that moment.","exampleAgentPrompt":"Can you clip the part where she says 'I don't have online' from this YouTube video https://www.youtube.com/watch?v=jK-ZRxeJIiU — keep it under 30 seconds?","exampleUseCases":null,"resultDescription":"Returns a public mp4 URL of the extracted clip, the start and end timestamps within the source media, the transcript text covered by the clip, a one-sentence LLM explanation of why that moment was chosen, and cache status flags for the clip, source, and transcript.","failureModes":["Media URL is inaccessible or not supported by yt-dlp — returns an error","Query does not match any identifiable moment in the transcript — no clip returned","Clip exceeds max_clip_seconds and is center-trimmed, potentially cutting off context","Transcription fails for non-speech or low-quality audio","Source media is too long or large, causing timeout","Network error fetching the remote media URL"],"whenToPreferThis":"Use this endpoint when you need to extract a single specific moment from a media file based on a natural language description. It is ideal when the source is a YouTube video, podcast, Twitch VOD, or direct mp4 and you want a ready-to-use mp4 clip URL back. Prefer this over general video download tools when semantic search over the transcript is needed to locate the right moment, and over the multi-source stitch endpoint when you only need one clip from one source.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":21,"lastUsedAt":"2026-06-12T16:56:45.769Z","lastSuccessfullyRanAt":"2026-05-07T15:40:00.365Z","lastHealthCheckAt":"2026-10-24T00:27:24.210Z","isFirstParty":false,"canonicalSlug":"ytclip-modestpika-box-ca-ytclip-single-media-clip-finder-and-cutter-6ed4064e"}