{"id":"transcribe-url","title":"Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT)","description":"Transcribes a public audio or video FILE URL (podcast enclosure, meeting recording, voice memo; mp3, wav, mp4/m4a, ogg, webm, flac; up to 25 MB and 30 minutes) with Whisper large-v3-turbo on Cloudflare Workers AI. Returns timestamped segments plus SRT and VTT subtitles and the plain text, bound to the media's SHA-256. Does NOT accept YouTube, Spotify or any streaming page (the URL must be the media file itself), does not identify speakers, and does not translate.","roi":"A 30-minute recording becomes searchable text and ready-to-use subtitles, tied to the exact file bytes, for $0.25.","audience":"business","channels":["x402","mcp","rapidapi","apify"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/transcribe-url","path":"/api/v1/transcribe-url","contentType":"application/json"},"price":{"amount":"0.25","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","minLength":8,"maxLength":2048,"pattern":"^https://","description":"https URL of the audio or video file itself."},"language":{"type":"string","pattern":"^[a-z]{2}$","description":"ISO 639-1 language code of the speech (for example en); detected when omitted."},"formats":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"string","enum":["segments","srt","vtt","text"]},"description":"Outputs to include; default all."},"max_minutes":{"type":"integer","minimum":1,"maximum":30,"description":"Reject audio longer than this, default 30."}}},"resultSchema":{"type":"object","properties":{"url":{"type":"string"},"final_url":{"type":"string","description":"URL after redirects."},"media_sha256":{"type":"string","description":"SHA-256 (hex) of the downloaded media bytes."},"bytes":{"type":"integer"},"container":{"type":"string","enum":["mp3","wav","mp4","ogg","webm","flac"]},"duration_seconds":{"anyOf":[{"type":"number","description":"From the container for mp3/wav, else from the model; null when unknown."},{"type":"null"}]},"language":{"anyOf":[{"type":"string","description":"Detected or requested language; null when unknown."},{"type":"null"}]},"model":{"type":"string"},"chunks":{"type":"integer","description":"Model requests used; mp3 and wav are split into at most 10-minute chunks."},"text":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"}}}},"srt":{"anyOf":[{"type":"string","description":"SubRip subtitles, max 2 lines of 42 characters per cue; null when not requested."},{"type":"null"}]},"vtt":{"anyOf":[{"type":"string","description":"WebVTT subtitles; null when not requested."},{"type":"null"}]},"word_count":{"type":"integer"},"truncated":{"type":"boolean","description":"True when text was cut to bound the response size."},"limits":{"type":"object","properties":{"max_bytes":{"type":"integer"},"max_minutes":{"type":"integer"},"note":{"type":"string"}}}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string"},"final_url":{"type":"string","description":"URL after redirects."},"media_sha256":{"type":"string","description":"SHA-256 (hex) of the downloaded media bytes."},"bytes":{"type":"integer"},"container":{"type":"string","enum":["mp3","wav","mp4","ogg","webm","flac"]},"duration_seconds":{"anyOf":[{"type":"number","description":"From the container for mp3/wav, else from the model; null when unknown."},{"type":"null"}]},"language":{"anyOf":[{"type":"string","description":"Detected or requested language; null when unknown."},{"type":"null"}]},"model":{"type":"string"},"chunks":{"type":"integer","description":"Model requests used; mp3 and wav are split into at most 10-minute chunks."},"text":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"}}}},"srt":{"anyOf":[{"type":"string","description":"SubRip subtitles, max 2 lines of 42 characters per cue; null when not requested."},{"type":"null"}]},"vtt":{"anyOf":[{"type":"string","description":"WebVTT subtitles; null when not requested."},{"type":"null"}]},"word_count":{"type":"integer"},"truncated":{"type":"boolean","description":"True when text was cut to bound the response size."},"limits":{"type":"object","properties":{"max_bytes":{"type":"integer"},"max_minutes":{"type":"integer"},"note":{"type":"string"}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"url":"https://archive.org/download/testmp3testfile/mpthreetest.mp3","language":"en","formats":["segments","srt"],"max_minutes":5},"openapiOperation":{"operationId":"transcribe_url","summary":"Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT)","description":"Transcribes a public audio or video FILE URL (podcast enclosure, meeting recording, voice memo; mp3, wav, mp4/m4a, ogg, webm, flac; up to 25 MB and 30 minutes) with Whisper large-v3-turbo on Cloudflare Workers AI. Returns timestamped segments plus SRT and VTT subtitles and the plain text, bound to the media's SHA-256. Does NOT accept YouTube, Spotify or any streaming page (the URL must be the media file itself), does not identify speakers, and does not translate.\n\nPrice: 0.25 USDC on Base (x402).","x-x402-price-usdc":"0.25","x-x402-amount":"250000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"}},"x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/transcribe-url","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","minLength":8,"maxLength":2048,"pattern":"^https://","description":"https URL of the audio or video file itself."},"language":{"type":"string","pattern":"^[a-z]{2}$","description":"ISO 639-1 language code of the speech (for example en); detected when omitted."},"formats":{"type":"array","minItems":1,"maxItems":4,"items":{"type":"string","enum":["segments","srt","vtt","text"]},"description":"Outputs to include; default all."},"max_minutes":{"type":"integer","minimum":1,"maximum":30,"description":"Reject audio longer than this, default 30."}}},"example":{"url":"https://archive.org/download/testmp3testfile/mpthreetest.mp3","language":"en","formats":["segments","srt"],"max_minutes":5}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string"},"final_url":{"type":"string","description":"URL after redirects."},"media_sha256":{"type":"string","description":"SHA-256 (hex) of the downloaded media bytes."},"bytes":{"type":"integer"},"container":{"type":"string","enum":["mp3","wav","mp4","ogg","webm","flac"]},"duration_seconds":{"anyOf":[{"type":"number","description":"From the container for mp3/wav, else from the model; null when unknown."},{"type":"null"}]},"language":{"anyOf":[{"type":"string","description":"Detected or requested language; null when unknown."},{"type":"null"}]},"model":{"type":"string"},"chunks":{"type":"integer","description":"Model requests used; mp3 and wav are split into at most 10-minute chunks."},"text":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"}}}},"srt":{"anyOf":[{"type":"string","description":"SubRip subtitles, max 2 lines of 42 characters per cue; null when not requested."},{"type":"null"}]},"vtt":{"anyOf":[{"type":"string","description":"WebVTT subtitles; null when not requested."},{"type":"null"}]},"word_count":{"type":"integer"},"truncated":{"type":"boolean","description":"True when text was cut to bound the response size."},"limits":{"type":"object","properties":{"max_bytes":{"type":"integer"},"max_minutes":{"type":"integer"},"note":{"type":"string"}}}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/transcribe-url/","docsJson":"https://agents.writerslogic.com/docs/transcribe-url.json","sample":"https://agents.writerslogic.com/api/v1/samples/transcribe-url","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}