Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.
Cloud storage (S3, Google Cloud Storage, Azure Blob)
Social media platforms (YouTube, Twitter, etc.)
Any publicly accessible audio/video URL
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Transcription request. Must provide audio_url for URL-based transcription.
audio_url
string<uri>
required
Remote audio/video URL (social media or cloud storage).
language
string
(Optional) Language hint (BCP-47 code, e.g., 'en-US', 'es-ES'). Defaults to 'auto' for automatic detection.
format
enum<string>[]
(Optional) Output formats to generate. Available: doc, pdf, txt, markdown, srt, vtt, csv, json. Defaults to ["json"] if not provided.
Available options:
doc,
pdf,
txt,
markdown,
srt,
vtt,
csv,
json
callback
string<uri>
(Optional) Webhook URL for async processing. If provided, the job runs asynchronously and results are sent to this URL when complete. Without callback, the endpoint processes synchronously.
diarize
boolean
default:false
(Optional) Enable speaker diarization to identify different speakers.
team_id
string
(Optional) Team identifier. If not provided, uses your default workspace.
folder_id
string
(Optional) Folder identifier. If not provided, file will be added to the root of the workspace.
output_config
object
(Optional) Configuration for output formatting.
Show child attributes
Response
Transcription response. Returns one of two response types:
Option 1 - Completed (status: "completed"): Returned when no callback URL is provided (synchronous processing). Response includes status, id, and data with all requested formats (defaults to json if not specified).
Option 2 - Pending (status: "pending"): Only returned when callback URL is provided (asynchronous processing). Response includes status, id, and poll_url to check progress. Results will be sent to the callback URL when complete.
Option 1
Option 2
status
enum<string>
required
Available options:
completed
id
string
required
data
object
required
Map of requested formats to their data. Only formats specified in the request will be present. If no formats were specified, defaults to json only.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SkyScribe Docs","colors":{"primary":"#7033ff","light":"#7033ff","dark":"#7033ff"},"logo":{"light":"https://mintcdn.com/skyscribe/GHBzTSqrX9aKLvYN/logo/dark_logo.png?fit=max\u0026auto=format\u0026n=GHBzTSqrX9aKLvYN\u0026q=85\u0026s=4c3ba711ae5dc6d5687887b8fd136afe","dark":"https://mintcdn.com/skyscribe/GHBzTSqrX9aKLvYN/logo/light_logo.png?fit=max\u0026auto=format\u0026n=GHBzTSqrX9aKLvYN\u0026q=85\u0026s=32f9646370de34b65ae3f25f16cd9b06"},"favicon":"/logo/favicon.ico","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://app.sky-scribe.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"skyscribe","hasAudioNarration":false,"actualSubdomain":"skyscribe","customDomains":["docs.sky-scribe.com"],"gitSource":{"type":"github","owner":"haonan-diamond","repo":"skyscribe-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae9412c45a5319bda26b9dd:success","clientVersion":"0.0.4269","searchFilterCounts":[{"language":"default","tag":"Guides","count":22},{"language":"default","tag":"Features","count":8},{"language":"default","tag":"API Reference","count":7},{"language":"default","tag":"Workflow examples","count":7},{"language":"default","tag":"Transcribe","count":3},{"language":"default","tag":"Quickstart","count":3},{"language":"default","tag":"Extract","count":2},{"language":"default","tag":"Translate","count":2},{"language":"default","tag":"Technology","count":2},{"language":"default","tag":"Affiliate","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"nav img{max-height:35px!important;height:auto!important;width:auto!important}.navbar-logo img,[class*=\"logo\"] img,a[href=\"/\"] img{max-height:35px!important;height:auto!important;width:auto!important}"}]}
{"page":{"pagePath":"api-reference/endpoint/create-from-url","slug":"/api-reference/endpoint/create-from-url","pageMetadata":{"title":"Transcribe from URL","openapi":"POST /v1/transcribe-url","description":"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.","href":"/api-reference/endpoint/create-from-url"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Submit a remote audio or video URL for transcription. Perfect for transcribing files hosted on cloud storage or social media platforms.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`For file uploads instead, see `,_jsx(_components.a,{href:`/api-reference/endpoint/create-from-file`,children:`Transcribe from File`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-urls`,children:`Supported URLs`}),`\n`,_jsx(_components.p,{children:`You can transcribe audio from:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Cloud storage (S3, Google Cloud Storage, Azure Blob)`}),`\n`,_jsx(_components.li,{children:`Social media platforms (YouTube, Twitter, etc.)`}),`\n`,_jsx(_components.li,{children:`Any publicly accessible audio/video URL`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Transcribe from URL","openapi":"POST /v1/transcribe-url","description":"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.","href":"/api-reference/endpoint/create-from-url"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Supported URLs","slug":"supported-urls","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"transcribeFromUrl","tags":["Transcribe"],"summary":"Transcribe from URL","description":"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.","requestBody":"7320bb41-b20c-4e08-8ed6-5aae072b6b17","responses":{"200":"0392049b-5733-4a4c-b0bf-a6ee94bbb9d6","4XX":"a728e69d-3e06-4ebf-b2cb-f50f4619efd2","5XX":"ec8563a4-cbcf-4e81-864d-0030d44e4952"},"method":"post","type":"path","servers":["27c78e66-8cb4-43e7-8376-a6bc30c663cf"],"security":["891b7ee1-404d-419c-89ff-4b6203a4e3de"],"path":"/v1/transcribe-url","baseUrlOptions":["https://api.sky-scribe.com"],"title":"Transcribe from URL","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Transcription request. Must provide `audio_url` for URL-based transcription.","properties":{"audio_url":{"type":"string","format":"uri","description":"Remote audio/video URL (social media or cloud storage).","isRequired":true,"uniqueKey":"audio_url","typeLabel":"string\u003curi>"},"language":{"type":"string","description":"(Optional) Language hint (BCP-47 code, e.g., 'en-US', 'es-ES'). Defaults to 'auto' for automatic detection.","uniqueKey":"language","typeLabel":"string"},"format":{"type":"array","description":"(Optional) Output formats to generate. Available: doc, pdf, txt, markdown, srt, vtt, csv, json. Defaults to [\"json\"] if not provided.","items":{"type":"string","enum":["doc","pdf","txt","markdown","srt","vtt","csv","json"],"example":"json","uniqueKey":"format.items.[INDEX]","typeLabel":"enum\u003cstring>"},"default":["json"],"uniqueKey":"format","typeLabel":"enum\u003cstring>[]"},"callback":{"type":"string","format":"uri","description":"(Optional) Webhook URL for async processing. If provided, the job runs asynchronously and results are sent to this URL when complete. Without callback, the endpoint processes synchronously.","uniqueKey":"callback","typeLabel":"string\u003curi>"},"diarize":{"type":"boolean","description":"(Optional) Enable speaker diarization to identify different speakers.","default":false,"uniqueKey":"diarize","typeLabel":"boolean"},"team_id":{"type":"string","description":"(Optional) Team identifier. If not provided, uses your default workspace.","uniqueKey":"team_id","typeLabel":"string"},"folder_id":{"type":"string","description":"(Optional) Folder identifier. If not provided, file will be added to the root of the workspace.","uniqueKey":"folder_id","typeLabel":"string"},"output_config":{"type":"object","description":"(Optional) Configuration for output formatting.","properties":{"include_timestamps":{"type":"boolean","description":"(Optional) Include timestamp information in the JSON data.","default":true,"uniqueKey":"output_config.include_timestamps","typeLabel":"boolean"},"include_speakers":{"type":"boolean","description":"(Optional) Include speaker labels in the JSON data (requires diarization).","default":false,"uniqueKey":"output_config.include_speakers","typeLabel":"boolean"}},"uniqueKey":"output_config","typeLabel":"object"}},"required":["audio_url"],"uniqueKey":"","typeLabel":"object"},"examples":{"url-transcription":{"title":"url-transcription","summary":"Transcribe from URL","value":{"audio_url":"https://example.com/audio.mp3","language":"en-US","format":["json","srt","txt"],"diarize":true}},"async-with-callback":{"title":"async-with-callback","summary":"Async transcription with callback","value":{"audio_url":"https://example.com/audio.mp3","callback":"https://your-server.com/webhook","format":["json","pdf","markdown"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"0392049b-5733-4a4c-b0bf-a6ee94bbb9d6":{"description":"Transcription response. Returns one of two response types:\n\n**Option 1 - Completed (status: \"completed\")**: Returned when no callback URL is provided (synchronous processing). Response includes status, id, and data with all requested formats (defaults to json if not specified).\n\n**Option 2 - Pending (status: \"pending\")**: Only returned when callback URL is provided (asynchronous processing). Response includes status, id, and poll_url to check progress. Results will be sent to the callback URL when complete.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["status","id","data"],"properties":{"status":{"type":"string","enum":["completed"],"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"data":{"type":"object","description":"Map of requested formats to their data. Only formats specified in the request will be present. If no formats were specified, defaults to json only.","properties":{"json":{"oneOf":[{"type":"object","properties":{"language":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.data.json.oneOf.0.language","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.data.json.oneOf.0.text","typeLabel":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX].id","typeLabel":"string"},"start":{"type":"number","format":"float","description":"Start time in seconds.","isRequired":true,"uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX].start","typeLabel":"number\u003cfloat>"},"end":{"type":"number","format":"float","description":"End time in seconds.","isRequired":true,"uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX].end","typeLabel":"number\u003cfloat>"},"text":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX].text","typeLabel":"string"},"speaker":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX].speaker.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX].speaker.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX].speaker","typeLabel":"string | null"}},"required":["id","start","end","text"],"uniqueKey":"oneOf.0.data.json.oneOf.0.segments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.data.json.oneOf.0.segments","typeLabel":"object[]"}},"required":["language","text"],"uniqueKey":"oneOf.0.data.json.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"language":{"type":"string"},"text":{"type":"string"},"segments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"start":{"type":"number","format":"float","description":"Start time in seconds."},"end":{"type":"number","format":"float","description":"End time in seconds."},"text":{"type":"string"},"speaker":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","start","end","text"]}}},"required":["language","text"],"uniqueKey":"oneOf.0.data.json.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.json","typeLabel":"object | null"},"doc":{"oneOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the DOC file","uniqueKey":"oneOf.0.data.doc.oneOf.0.url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0.data.doc.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the DOC file"}},"uniqueKey":"oneOf.0.data.doc.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.doc","typeLabel":"object | null"},"pdf":{"oneOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the PDF file","uniqueKey":"oneOf.0.data.pdf.oneOf.0.url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0.data.pdf.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the PDF file"}},"uniqueKey":"oneOf.0.data.pdf.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.pdf","typeLabel":"object | null"},"txt":{"oneOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the TXT file","uniqueKey":"oneOf.0.data.txt.oneOf.0.url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0.data.txt.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the TXT file"}},"uniqueKey":"oneOf.0.data.txt.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.txt","typeLabel":"object | null"},"markdown":{"oneOf":[{"type":"string","description":"Markdown formatted text content","uniqueKey":"oneOf.0.data.markdown.oneOf.0","typeLabel":"string"},{"type":"null","description":"Markdown formatted text content","uniqueKey":"oneOf.0.data.markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.markdown","typeLabel":"string | null"},"srt":{"oneOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the SRT file","uniqueKey":"oneOf.0.data.srt.oneOf.0.url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0.data.srt.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the SRT file"}},"uniqueKey":"oneOf.0.data.srt.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.srt","typeLabel":"object | null"},"vtt":{"oneOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the VTT file","uniqueKey":"oneOf.0.data.vtt.oneOf.0.url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0.data.vtt.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the VTT file"}},"uniqueKey":"oneOf.0.data.vtt.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.vtt","typeLabel":"object | null"},"csv":{"oneOf":[{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the CSV file","uniqueKey":"oneOf.0.data.csv.oneOf.0.url","typeLabel":"string\u003curi>"}},"uniqueKey":"oneOf.0.data.csv.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"url":{"type":"string","format":"uri","description":"Download URL for the CSV file"}},"uniqueKey":"oneOf.0.data.csv.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.data.csv","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.0.data","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["status","id","poll_url"],"properties":{"status":{"type":"string","enum":["pending"],"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"poll_url":{"type":"string","format":"uri","description":"URL to poll for updated status or completed result.","isRequired":true,"uniqueKey":"oneOf.1.poll_url","typeLabel":"string\u003curi>"},"estimated_wait_seconds":{"oneOf":[{"type":"integer","format":"int32","uniqueKey":"oneOf.1.estimated_wait_seconds.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","uniqueKey":"oneOf.1.estimated_wait_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.estimated_wait_seconds","typeLabel":"integer\u003cint32> | null"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"completed","id":"\u003cstring>","data":{"json":{"language":"\u003cstring>","text":"\u003cstring>","segments":[{"id":"\u003cstring>","start":123,"end":123,"text":"\u003cstring>","speaker":"\u003cstring>"}]},"doc":{"url":"\u003cstring>"},"pdf":{"url":"\u003cstring>"},"txt":{"url":"\u003cstring>"},"markdown":"\u003cstring>","srt":{"url":"\u003cstring>"},"vtt":{"url":"\u003cstring>"},"csv":{"url":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"a728e69d-3e06-4ebf-b2cb-f50f4619efd2":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"required":["type","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ec8563a4-cbcf-4e81-864d-0030d44e4952":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"}},"required":["type","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"891b7ee1-404d-419c-89ff-4b6203a4e3de":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"27c78e66-8cb4-43e7-8376-a6bc30c663cf":{"url":"https://api.sky-scribe.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"skyscribe","siteName":"SkyScribe Docs","title":"Transcribe from URL - SkyScribe Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/endpoint/create-from-url.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SkyScribe Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Transcribe from URL - SkyScribe Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SkyScribe Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://skyscribe.mintlify.site/_mintlify/api/og/v2?division=Transcribe\u0026amp;title=Transcribe+from+URL\u0026amp;description=Provide+a+remote+audio+or+video+URL+for+transcription.+Synchronously-oriented+endpoint+that+may+return+a+completed+result+or+pending+status+for+longer+jobs.\u0026amp;theme=3f0505aad075c514a327a1ba\u0026amp;signature=9c8aec889f760f3f0e918414dbf83e750a696b6ee452e8a56a5cbd3857f50823\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Transcribe from URL - SkyScribe Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://skyscribe.mintlify.site/_mintlify/api/og/v2?division=Transcribe\u0026amp;title=Transcribe+from+URL\u0026amp;description=Provide+a+remote+audio+or+video+URL+for+transcription.+Synchronously-oriented+endpoint+that+may+return+a+completed+result+or+pending+status+for+longer+jobs.\u0026amp;theme=3f0505aad075c514a327a1ba\u0026amp;signature=9c8aec889f760f3f0e918414dbf83e750a696b6ee452e8a56a5cbd3857f50823\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/skyscribe/jLRbAuMo0mhVOtSs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SkyScribe Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7033ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/create-from-url.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sky-scribe.com/#organization\",\"name\":\"SkyScribe Docs\",\"url\":\"https://docs.sky-scribe.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/skyscribe/GHBzTSqrX9aKLvYN/logo/dark_logo.png?fit=max\u0026auto=format\u0026n=GHBzTSqrX9aKLvYN\u0026q=85\u0026s=4c3ba711ae5dc6d5687887b8fd136afe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sky-scribe.com#website\",\"name\":\"SkyScribe Docs\",\"url\":\"https://docs.sky-scribe.com\",\"publisher\":{\"@id\":\"https://docs.sky-scribe.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url#webpage\",\"url\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url\",\"name\":\"Transcribe from URL\",\"description\":\"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.\",\"isPartOf\":{\"@id\":\"https://docs.sky-scribe.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transcribe\",\"item\":\"https://docs.sky-scribe.com/api-reference/endpoint/get\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transcribe from URL\",\"item\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url#apireference\",\"headline\":\"Transcribe from URL\",\"name\":\"Transcribe from URL\",\"description\":\"Provide a remote audio or video URL for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.\",\"url\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sky-scribe.com/api-reference/endpoint/create-from-url#webpage\"},\"publisher\":{\"@id\":\"https://docs.sky-scribe.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sky-scribe.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SkyScribe Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SkyScribe Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/create-from-url.md","siteName":"SkyScribe Docs","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Transcribe","pages":[{"title":"API Alpha Testing","description":"Endpoint details will be shared with approved alpha partners.","href":"/api-reference/endpoint/get"},{"title":"Transcribe from URL","openapi":"POST /v1/transcribe-url","href":"/api-reference/endpoint/create-from-url"},{"title":"Transcribe from File","openapi":"POST /v1/transcribe-file","description":"Upload an audio or video file for transcription. Synchronously-oriented endpoint that may return a completed result or pending status for longer jobs.","href":"/api-reference/endpoint/create-from-file"}]},{"group":"Translate","pages":[{"title":"Create Translation","openapi":"POST /v1/translate","href":"/api-reference/endpoint/translate"},{"title":"Get Translation","openapi":"GET /v1/translations/{id}","href":"/api-reference/endpoint/get-translation"}]},{"group":"Extract","pages":[{"title":"Create Extraction","openapi":"POST /v1/extract","href":"/api-reference/endpoint/extract"},{"title":"Get Extraction","openapi":"GET /v1/extractions/{id}","href":"/api-reference/endpoint/get-extraction"}]}]}]},"basePath":"","title":"Transcribe from URL - SkyScribe Docs","deploymentId":"dpl_7LpC8LvxVNTZSB7twCcVwH4TeFKv","buildId":"dpl_7LpC8LvxVNTZSB7twCcVwH4TeFKv","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-VIWbtsv8.js","snippetPresets-ewmdA2iz.js","utils-DEEnXwTM.js","style-to-object-BY3JEAdk.js","utils-BUI5OFKw.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DczDVjtE.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C1QFmpNs.js","_Uint8Array-0FSGLZoF.js","isObject-FP1Yky1u.js","ApiExamples-DNfazWM6.js","usePlaygroundInputsStore-CU9Zyvn9.js","shallow-DBWJPCN_.js","isEqual-BgubGfZd.js","CodeSnippets-WO5yBq5U.js","CodeSnippet-CATPUnsR.js","getApiPlaygroundDisplay-DVuSDqoz.js","Page-B2HLrc-g.js","DynamicMarkdown-D4bAuXRS.js","SectionHeading-BNNqN1He.js","icon-C7peNQV4.js","MethodPill-Bl2guf_0.js","getPastedJson-B_gFzCQb.js","Check2Icon-BLniSudB.js","axios-CsQoIw0U.js","Markdown-sagBpmAe.js","AssistantPageLink-CgMPWeT2.js","dist-C5tMjMKm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}