{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}
Get clip transcript
Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip’s playback start. Word indices are stable identifiers for cut-by-transcript; they don’t shift when cuts change. Pass startTimeMs/endTimeMs to read a long clip in windows; a word belongs to the window its start time falls in. Pass view=text for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. view=sentences gives one row per sentence instead. Pass includeCut=true to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.
{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}
{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}
Authorizations
Authorization
string
header
required
API key obtained from your Tella account settings
Path Parameters
id
string
required
Video identifier
Example:
"vid_abc123def456"
clipId
string
required
Clip identifier
Example:
"cl_xyz789ghi012"
Query Parameters
startTimeMs
integer
Only return items at or after this time, in ms on the clip's playback timeline. Defaults to the clip's start.
Required range: 0 <= x <= 9007199254740991
Example:
60000
endTimeMs
integer
Only return items before this time (exclusive), in ms on the clip's playback timeline. Must be greater than startTimeMs. Defaults to the clip's end. Page through a long clip with windows that meet end to start.
Required range: 1 <= x <= 9007199254740991
Example:
120000
view
enum<string>
words (default): every word with its index, times and flags. text: every word with its index as plain text, one sentence per line starting with its start time, about a seventh of the size, for reading a whole long clip (finding retakes, repeats or where something is said). sentences: one row per sentence (first and last word index, start and end time, text), about a quarter of the size. A time window cuts sentences at its edges.
Available options:
words,
sentences,
text
Example:
"text"
includeCut
enum<string>
true: also return the words that cuts removed, each marked cut, with every word's times in the clip's source recording (sourceStartTimeMs/sourceEndTimeMs). Use it to find footage the cuts took out, such as a retake, without undoing the cuts. Kept words still carry their playback startTimeMs/endTimeMs. startTimeMs/endTimeMs filter on the source times. Works with every view. In view=text and view=sentences, sentence times are source times and each cut word is written ~word~ (12:~word~ in the text view); a sentence whose every word was cut is marked cut.
Available options:
true,
false
Example:
"true"
Response
OK
Option 1
Option 2
Option 3
Option 4
Option 5
Clip transcript — what viewers hear.
words
object[]
required
Words on the playback timeline (cuts removed, times relative to the clip's playback start). Word indices are stable — they don't shift when cuts change; words inside cuts are simply absent.
Hide child attributes
words.breakAfter
boolean
required
Whether a subtitle break is forced after this word, so the next word always starts a new subtitle block
Example:
false
words.endTimeMs
number
required
Word end time, in ms on the clip's playback timeline
Required range: x >= 0
Example:
1800
words.hidden
boolean
required
Whether the word is hidden by an edit
Example:
false
words.index
integer
required
Stable index of the word in the source recording
Required range: 0 <= x <= 9007199254740991
Example:
12
words.keepWithNext
boolean
required
Whether this word's subtitle block is kept together with the next word across punctuation and pauses. The lines-per-block limit still applies and breakAfter wins.
Example:
false
words.startTimeMs
number
required
Word start time, in ms on the clip's playback timeline
Required range: x >= 0
Example:
1500
words.text
string
required
Word text
Example:
"Hello"
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Tella","colors":{"primary":"#8278FA","light":"#B1AAFC","dark":"#5E51F8"},"logo":{"light":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf","dark":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-dark.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=88323f6b0165ce29c00e3a1d80c82fe3"},"favicon":"https://mintcdn.com/tella/munSRGpiNeMNXMvc/favicon.svg?fit=max\u0026auto=format\u0026n=munSRGpiNeMNXMvc\u0026q=85\u0026s=1b25a4dc5d9a41a1a9238eda432a0cb6","api":{"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"all","prefill":true},"url":"full","mdx":{"auth":{"method":"bearer"}}},"navbar":{"primary":{"type":"button","label":"Open Tella","href":"https://www.tella.com/videos"}},"footer":{"socials":{"github":"https://github.com/tellahq","x":"https://x.com/tellahq","linkedin":"https://linkedin.com/company/tellahq","youtube":"https://youtube.com/@tellahq","website":"https://tella.com","instagram":"https://instagram.com/tellahq"},"links":[{"header":"Tella features","items":[{"label":"Video trimming","href":"https://www.tella.com/features/video-trimming"},{"label":"Viewer downloads","href":"https://www.tella.com/features/viewer-download"},{"label":"4K export","href":"https://www.tella.com/features/4k-export"},{"label":"AI editing","href":"https://www.tella.com/features/ai-editing"},{"label":"Custom branding","href":"https://www.tella.com/features/custom-branding"},{"label":"Upload video","href":"https://www.tella.com/features/video-upload"},{"label":"Video clips","href":"https://www.tella.com/features/clips"},{"label":"Custom backgrounds","href":"https://www.tella.com/features/custom-backgrounds"},{"label":"All features","href":"https://www.tella.com/features"}]}]},"seo":{"paths":[{"path":"help","metatags":{"canonical":"https://www.tella.com"}},{"path":"changelog","metatags":{"canonical":"https://www.tella.com"}}]},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"contextual":{"options":["copy","assistant","view","chatgpt","claude","perplexity","grok","mcp","add-mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"schema":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tella","hasAudioNarration":false,"actualSubdomain":"tella","customDomains":["www.tella.com"],"gitSource":{"type":"github","owner":"tellahq","repo":"tella-fusion","deployBranch":"main","contentDirectory":"packages/core/webapp/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"contextualFeedback":{"allowEmail":true},"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00ef34c953c2aa6bb620f0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Help Center","count":272},{"language":"default","tag":"Developers","count":216},{"language":"default","tag":"API Reference","count":163},{"language":"default","tag":"Edit","count":75},{"language":"default","tag":"Clips","count":63},{"language":"default","tag":"Share and embed","count":41},{"language":"default","tag":"Videos","count":40},{"language":"default","tag":"MCP Tools","count":35},{"language":"default","tag":"Troubleshooting and support","count":33},{"language":"default","tag":"Account and workspace","count":31}],"searchSettings":{"isFiltersEnabled":true,"maxResults":15,"showContentSnippets":true,"fullPageSearch":true}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"type":"email","email":"support@tella.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"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}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/clips/get-clip-transcript","slug":"/api-reference/clips/get-clip-transcript","pageMetadata":{"title":"Get clip transcript","description":"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip's playback start. Word indices are stable identifiers for cut-by-transcript; they don't shift when cuts change. Pass `startTimeMs`/`endTimeMs` to read a long clip in windows; a word belongs to the window its start time falls in. Pass `view=text` for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. `view=sentences` gives one row per sentence instead. Pass `includeCut=true` to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/transcript","href":"/api-reference/clips/get-clip-transcript","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip’s playback start. Word indices are stable identifiers for cut-by-transcript; they don’t shift when cuts change. Pass \", _jsx(_components.code, {\n children: \"startTimeMs\"\n }), \"/\", _jsx(_components.code, {\n children: \"endTimeMs\"\n }), \" to read a long clip in windows; a word belongs to the window its start time falls in. Pass \", _jsx(_components.code, {\n children: \"view=text\"\n }), \" for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. \", _jsx(_components.code, {\n children: \"view=sentences\"\n }), \" gives one row per sentence instead. Pass \", _jsx(_components.code, {\n children: \"includeCut=true\"\n }), \" to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get clip transcript","description":"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip's playback start. Word indices are stable identifiers for cut-by-transcript; they don't shift when cuts change. Pass `startTimeMs`/`endTimeMs` to read a long clip in windows; a word belongs to the window its start time falls in. Pass `view=text` for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. `view=sentences` gives one row per sentence instead. Pass `includeCut=true` to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/transcript","href":"/api-reference/clips/get-clip-transcript","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/tella/0df50391d431fa00/support-chat.js","/docs/_mintlify/custom/tella/7e6fe091e3982139/lettervisit.js"],"openApiReferenceData":{"operation":{"description":"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip's playback start. Word indices are stable identifiers for cut-by-transcript; they don't shift when cuts change. Pass `startTimeMs`/`endTimeMs` to read a long clip in windows; a word belongs to the window its start time falls in. Pass `view=text` for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. `view=sentences` gives one row per sentence instead. Pass `includeCut=true` to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.","operationId":"getClipTranscript","parameters":["afb0d860-4e19-4f1b-af64-907ee4045563","2a3f8a46-04dd-48d9-a8ce-babc086b2487","d133da1c-f242-4dd4-b8cb-8e399ce97b5a","50e71ed5-978a-4983-9f9d-ba9f7537748e","ba8b822b-f90f-487f-9ced-3ec8b6a831d7","64b80325-a29a-4c6d-93a7-f5c30dd26a6d"],"responses":{"200":"f6177688-e3a6-407f-93bd-b735a3e96233","400":"a81020b3-7cb3-4e1d-b124-6074e5a7db7d","401":"f38b1093-1468-49b4-9936-5bbc2a6e614d","403":"d0a6823b-06c5-4bda-aebb-95a3ca635586","404":"712a02ec-3d83-4564-8d13-c6c0e47856c7","409":"0205620a-dff7-49e6-be14-41f37d0ac121","429":"c06c8ace-2d17-435e-8040-332920d51323","500":"b46a8304-cd94-4fa9-8aa3-baee29490ab2","501":"adcd68c2-4400-4349-926b-6c6a3a814648","503":"b4082435-2e9c-4097-acbd-db15f0aeb641"},"security":["cce33f57-17d1-4d3e-9c5c-4d1d07df3fd2"],"summary":"Get clip transcript","tags":["Clips"],"method":"get","type":"path","servers":["d2aabac2-b2bc-4b47-a6f4-a26614a56f79"],"path":"/v1/videos/{id}/clips/{clipId}/transcript","baseUrlOptions":["https://api.tella.com"],"title":"Get clip transcript","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"afb0d860-4e19-4f1b-af64-907ee4045563":{"description":"Video identifier","in":"path","name":"id","required":true,"schema":{"description":"Video identifier","example":"vid_abc123def456","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"2a3f8a46-04dd-48d9-a8ce-babc086b2487":{"description":"Clip identifier","in":"path","name":"clipId","required":true,"schema":{"description":"Clip identifier","example":"cl_xyz789ghi012","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"d133da1c-f242-4dd4-b8cb-8e399ce97b5a":{"description":"Only return items at or after this time, in ms on the clip's playback timeline. Defaults to the clip's start.","in":"query","name":"startTimeMs","schema":{"description":"Only return items at or after this time, in ms on the clip's playback timeline. Defaults to the clip's start.","example":60000,"maximum":9007199254740991,"minimum":0,"type":"integer","uniqueKey":"","typeLabel":"integer"}},"50e71ed5-978a-4983-9f9d-ba9f7537748e":{"description":"Only return items before this time (exclusive), in ms on the clip's playback timeline. Must be greater than `startTimeMs`. Defaults to the clip's end. Page through a long clip with windows that meet end to start.","in":"query","name":"endTimeMs","schema":{"description":"Only return items before this time (exclusive), in ms on the clip's playback timeline. Must be greater than `startTimeMs`. Defaults to the clip's end. Page through a long clip with windows that meet end to start.","example":120000,"maximum":9007199254740991,"minimum":1,"type":"integer","uniqueKey":"","typeLabel":"integer"}},"ba8b822b-f90f-487f-9ced-3ec8b6a831d7":{"description":"`words` (default): every word with its index, times and flags. `text`: every word with its index as plain text, one sentence per line starting with its start time, about a seventh of the size, for reading a whole long clip (finding retakes, repeats or where something is said). `sentences`: one row per sentence (first and last word index, start and end time, text), about a quarter of the size. A time window cuts sentences at its edges.","in":"query","name":"view","schema":{"description":"`words` (default): every word with its index, times and flags. `text`: every word with its index as plain text, one sentence per line starting with its start time, about a seventh of the size, for reading a whole long clip (finding retakes, repeats or where something is said). `sentences`: one row per sentence (first and last word index, start and end time, text), about a quarter of the size. A time window cuts sentences at its edges.","enum":["words","sentences","text"],"example":"text","type":"string","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"64b80325-a29a-4c6d-93a7-f5c30dd26a6d":{"description":"`true`: also return the words that cuts removed, each marked `cut`, with every word's times in the clip's source recording (`sourceStartTimeMs`/`sourceEndTimeMs`). Use it to find footage the cuts took out, such as a retake, without undoing the cuts. Kept words still carry their playback `startTimeMs`/`endTimeMs`. `startTimeMs`/`endTimeMs` filter on the source times. Works with every view. In `view=text` and `view=sentences`, sentence times are source times and each cut word is written `~word~` (`12:~word~` in the text view); a sentence whose every word was cut is marked `cut`.","in":"query","name":"includeCut","schema":{"description":"`true`: also return the words that cuts removed, each marked `cut`, with every word's times in the clip's source recording (`sourceStartTimeMs`/`sourceEndTimeMs`). Use it to find footage the cuts took out, such as a retake, without undoing the cuts. Kept words still carry their playback `startTimeMs`/`endTimeMs`. `startTimeMs`/`endTimeMs` filter on the source times. Works with every view. In `view=text` and `view=sentences`, sentence times are source times and each cut word is written `~word~` (`12:~word~` in the text view); a sentence whose every word was cut is marked `cut`.","enum":["true","false"],"example":"true","type":"string","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"f6177688-e3a6-407f-93bd-b735a3e96233":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Clip transcript — what viewers hear.","required":["words"],"properties":{"words":{"description":"Words on the playback timeline (cuts removed, times relative to the clip's playback start). Word indices are stable — they don't shift when cuts change; words inside cuts are simply absent.","items":{"additionalProperties":false,"description":"A single transcribed word","properties":{"breakAfter":{"description":"Whether a subtitle break is forced after this word, so the next word always starts a new subtitle block","example":false,"type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.words.items.[INDEX].breakAfter","typeLabel":"boolean"},"endTimeMs":{"description":"Word end time, in ms on the clip's playback timeline","example":1800,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.0.words.items.[INDEX].endTimeMs","typeLabel":"number"},"hidden":{"description":"Whether the word is hidden by an edit","example":false,"type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.words.items.[INDEX].hidden","typeLabel":"boolean"},"index":{"description":"Stable index of the word in the source recording","example":12,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"oneOf.0.words.items.[INDEX].index","typeLabel":"integer"},"keepWithNext":{"description":"Whether this word's subtitle block is kept together with the next word across punctuation and pauses. The lines-per-block limit still applies and `breakAfter` wins.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.words.items.[INDEX].keepWithNext","typeLabel":"boolean"},"startTimeMs":{"description":"Word start time, in ms on the clip's playback timeline","example":1500,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.0.words.items.[INDEX].startTimeMs","typeLabel":"number"},"text":{"description":"Word text","example":"Hello","type":"string","isRequired":true,"uniqueKey":"oneOf.0.words.items.[INDEX].text","typeLabel":"string"}},"required":["index","startTimeMs","endTimeMs","text","hidden","breakAfter","keepWithNext"],"type":"object","uniqueKey":"oneOf.0.words.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.words","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Clip transcript as sentences (`view=sentences`).","required":["sentences"],"properties":{"sentences":{"description":"Sentences on the playback timeline (cuts removed), split at `.`, `?` and `!`. Word indices can have gaps where words were cut.","items":{"additionalProperties":false,"properties":{"endTimeMs":{"description":"End of the last word, in ms on the clip's playback timeline","example":4200,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.1.sentences.items.[INDEX].endTimeMs","typeLabel":"number"},"firstIndex":{"description":"Index of the sentence's first word","example":12,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.sentences.items.[INDEX].firstIndex","typeLabel":"integer"},"lastIndex":{"description":"Index of the sentence's last word","example":19,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.sentences.items.[INDEX].lastIndex","typeLabel":"integer"},"startTimeMs":{"description":"Start of the first word, in ms on the clip's playback timeline","example":1500,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.1.sentences.items.[INDEX].startTimeMs","typeLabel":"number"},"text":{"description":"The sentence's words joined with spaces","example":"Hello and welcome to the demo.","type":"string","isRequired":true,"uniqueKey":"oneOf.1.sentences.items.[INDEX].text","typeLabel":"string"}},"required":["firstIndex","lastIndex","startTimeMs","endTimeMs","text"],"type":"object","uniqueKey":"oneOf.1.sentences.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.sentences","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","description":"Clip transcript as indexed text (`view=text`).","required":["text"],"properties":{"text":{"description":"The transcript on the playback timeline (cuts removed) as plain text: one sentence per line, split at `.`, `?` and `!`, starting with the sentence's start time as `[m:ss.s]`, then each word as `index:word`. Word indices can have gaps where words were cut.","example":"[0:01.5] 12:Hello 13:and 14:welcome.\n[0:04.2] 15:Let's 16:start.","type":"string","isRequired":true,"uniqueKey":"oneOf.2.text","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.2","typeLabel":"object"},{"type":"object","description":"Clip transcript with cut words (`includeCut=true`).","required":["words"],"properties":{"words":{"description":"Every word of the clip's recording in order, including the ones cuts removed (`includeCut=true`).","items":{"additionalProperties":false,"description":"A word of the clip's recording, kept or cut","properties":{"index":{"description":"Stable index of the word in the source recording","example":12,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"oneOf.3.words.items.[INDEX].index","typeLabel":"integer"},"sourceEndTimeMs":{"description":"End of the word, in ms into the clip's source recording","example":8540,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.3.words.items.[INDEX].sourceEndTimeMs","typeLabel":"number"},"sourceStartTimeMs":{"description":"Start of the word, in ms into the clip's source recording","example":8220,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.3.words.items.[INDEX].sourceStartTimeMs","typeLabel":"number"},"text":{"description":"Word text","example":"Hello","type":"string","isRequired":true,"uniqueKey":"oneOf.3.words.items.[INDEX].text","typeLabel":"string"},"cut":{"description":"Present (true) when a cut removed the word","enum":[true],"type":"boolean","uniqueKey":"oneOf.3.words.items.[INDEX].cut","typeLabel":"enum\u003cboolean>"},"endTimeMs":{"description":"End of the word on the clip's playback timeline. Absent for a cut word.","example":1800,"minimum":0,"type":"number","uniqueKey":"oneOf.3.words.items.[INDEX].endTimeMs","typeLabel":"number"},"startTimeMs":{"description":"Start of the word on the clip's playback timeline. Absent for a cut word.","example":1500,"minimum":0,"type":"number","uniqueKey":"oneOf.3.words.items.[INDEX].startTimeMs","typeLabel":"number"}},"required":["index","text","sourceStartTimeMs","sourceEndTimeMs"],"type":"object","uniqueKey":"oneOf.3.words.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.3.words","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.3","typeLabel":"object"},{"type":"object","description":"Clip transcript as sentences with cut words (`includeCut=true\u0026view=sentences`).","required":["sentences"],"properties":{"sentences":{"description":"Every sentence of the clip's recording in order, including the ones cuts removed (`includeCut=true\u0026view=sentences`).","items":{"additionalProperties":false,"description":"A sentence of the clip's recording, kept, cut or partly cut","properties":{"firstIndex":{"description":"Index of the sentence's first word","example":12,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"oneOf.4.sentences.items.[INDEX].firstIndex","typeLabel":"integer"},"lastIndex":{"description":"Index of the sentence's last word","example":19,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"oneOf.4.sentences.items.[INDEX].lastIndex","typeLabel":"integer"},"sourceEndTimeMs":{"description":"End of the last word, in ms into the clip's source recording","example":11400,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.4.sentences.items.[INDEX].sourceEndTimeMs","typeLabel":"number"},"sourceStartTimeMs":{"description":"Start of the first word, in ms into the clip's source recording","example":8220,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"oneOf.4.sentences.items.[INDEX].sourceStartTimeMs","typeLabel":"number"},"text":{"description":"The sentence's words joined with spaces, each cut word written `~word~`","example":"~So the plan~ So the plan is simple.","type":"string","isRequired":true,"uniqueKey":"oneOf.4.sentences.items.[INDEX].text","typeLabel":"string"},"cut":{"description":"Present (true) when cuts removed every word of the sentence","enum":[true],"type":"boolean","uniqueKey":"oneOf.4.sentences.items.[INDEX].cut","typeLabel":"enum\u003cboolean>"}},"required":["firstIndex","lastIndex","sourceStartTimeMs","sourceEndTimeMs","text"],"type":"object","uniqueKey":"oneOf.4.sentences.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.4.sentences","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.4","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"words":[{"breakAfter":false,"endTimeMs":1800,"hidden":false,"index":12,"keepWithNext":false,"startTimeMs":1500,"text":"Hello"}]}}},"exampleType":"generated"}},"description":"OK","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"generated"},"a81020b3-7cb3-4e1d-b124-6074e5a7db7d":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."}}},"exampleType":"examples"}},"description":"The request was malformed or contained invalid parameters.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"f38b1093-1468-49b4-9936-5bbc2a6e614d":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."}}},"exampleType":"examples"}},"description":"Authentication is required. Provide a valid API key.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"d0a6823b-06c5-4bda-aebb-95a3ca635586":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."}}},"exampleType":"examples"}},"description":"You don't have permission to access this resource.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"712a02ec-3d83-4564-8d13-c6c0e47856c7":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."}}},"exampleType":"examples"}},"description":"The requested resource was not found.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"0205620a-dff7-49e6-be14-41f37d0ac121":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"conflict","message":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"conflict","message":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."}}},"exampleType":"examples"}},"description":"The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"c06c8ace-2d17-435e-8040-332920d51323":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."}}},"exampleType":"examples"}},"description":"You have exceeded the rate limit. Please slow down.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a rate-limited request","example":45,"schema":{"minimum":1,"type":"integer"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"b46a8304-cd94-4fa9-8aa3-baee29490ab2":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"}}},"exampleType":"examples"}},"description":"An unexpected error occurred","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"adcd68c2-4400-4349-926b-6c6a3a814648":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."}}},"exampleType":"examples"}},"description":"The requested operation is not implemented.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"b4082435-2e9c-4097-acbd-db15f0aeb641":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"unavailable","message":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"unavailable","message":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."}}},"exampleType":"examples"}},"description":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"}},"security":{"cce33f57-17d1-4d3e-9c5c-4d1d07df3fd2":{"BearerAuth":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"d2aabac2-b2bc-4b47-a6f4-a26614a56f79":{"description":"Production","url":"https://api.tella.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key obtained from your Tella account settings","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"tella","siteName":"Tella","title":"Get clip transcript - Tella","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[{"tab":"Help Center"},{"tab":"Developers"},{"tab":"Changelog"}]},"originalFileLocation":"api-reference/clips/get-clip-transcript.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=\"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip\u0026#x27;s playback start. Word indices are stable identifiers for cut-by-transcript; they don\u0026#x27;t shift when cuts change. Pass startTimeMs/endTimeMs to read a long clip in windows; a word belongs to the window its start time falls in. Pass view=text for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. view=sentences gives one row per sentence instead. Pass includeCut=true to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tella\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_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=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get clip transcript - Tella\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip\u0026#x27;s playback start. Word indices are stable identifiers for cut-by-transcript; they don\u0026#x27;t shift when cuts change. Pass startTimeMs/endTimeMs to read a long clip in windows; a word belongs to the window its start time falls in. Pass view=text for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. view=sentences gives one row per sentence instead. Pass includeCut=true to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tella\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Clips\u0026amp;title=Get+clip+transcript\u0026amp;description=Returns+the+words+spoken+in+a+clip+with+cuts+applied+%E2%80%94+what+viewers+actually+hear.+Times+are+in+ms+relative+to+the+clip%27s+playback+start.+Word+indices+are+stabl\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=f163db090d2eef04b19f10d445ef30498d8dd6dd5b4d8bbbeb7a4a67365e9cbe\">\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=\"Get clip transcript - Tella\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip\u0026#x27;s playback start. Word indices are stable identifiers for cut-by-transcript; they don\u0026#x27;t shift when cuts change. Pass startTimeMs/endTimeMs to read a long clip in windows; a word belongs to the window its start time falls in. Pass view=text for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. view=sentences gives one row per sentence instead. Pass includeCut=true to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Clips\u0026amp;title=Get+clip+transcript\u0026amp;description=Returns+the+words+spoken+in+a+clip+with+cuts+applied+%E2%80%94+what+viewers+actually+hear.+Times+are+in+ms+relative+to+the+clip%27s+playback+start.+Word+indices+are+stabl\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=f163db090d2eef04b19f10d445ef30498d8dd6dd5b4d8bbbeb7a4a67365e9cbe\">\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=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tella\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8278FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/clips/get-clip-transcript.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.tella.com/#organization\",\"name\":\"Tella\",\"url\":\"https://www.tella.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.tella.com/docs#website\",\"name\":\"Tella\",\"url\":\"https://www.tella.com/docs\",\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript#webpage\",\"url\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript\",\"name\":\"Get clip transcript\",\"description\":\"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip's playback start. Word indices are stable identifiers for cut-by-transcript; they don't shift when cuts change. Pass startTimeMs/endTimeMs to read a long clip in windows; a word belongs to the window its start time falls in. Pass view=text for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. view=sentences gives one row per sentence instead. Pass includeCut=true to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.\",\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://www.tella.com/docs/api-reference/account/get-the-account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Clips\",\"item\":\"https://www.tella.com/docs/api-reference/clips/list-text-presets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get clip transcript\",\"item\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript#apireference\",\"headline\":\"Get clip transcript\",\"name\":\"Get clip transcript\",\"description\":\"Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip's playback start. Word indices are stable identifiers for cut-by-transcript; they don't shift when cuts change. Pass startTimeMs/endTimeMs to read a long clip in windows; a word belongs to the window its start time falls in. Pass view=text for every word with its index as plain text, one sentence per line, about a seventh of the size: read a whole long clip that way (to find retakes, repeats or where something is said), then the words view for a stretch where you need exact times. view=sentences gives one row per sentence instead. Pass includeCut=true to also get the words cuts removed, with their times in the source recording. Answers 503 while a clip that was just recorded is still being transcribed; retry after about 30 seconds.\",\"url\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript\",\"mainEntityOfPage\":{\"@id\":\"https://www.tella.com/docs/api-reference/clips/get-clip-transcript#webpage\"},\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tella\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tella\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/clips/get-clip-transcript.md","siteName":"Tella","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help/introduction/welcome"}]},{"tab":"Developers","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Set up the Tella MCP server for your AI agent","sidebarTitle":"AI agent setup","href":"/ai-onboarding"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Rate limiting","href":"/rate-limiting"},{"title":"API versioning and deprecation","href":"/versioning"}]},{"group":"Guides","pages":[{"title":"Webhooks","href":"/webhooks"},{"title":"Model Context Protocol (MCP)","href":"/mcp-server"},{"title":"Media library API","href":"/media-library-api"},{"title":"Embed API","href":"/embed-api"}]},{"group":"MCP Tools","pages":[{"group":"Managing videos","pages":[{"title":"Videos","href":"/mcp-tools/videos"},{"title":"Playlists","href":"/mcp-tools/playlists"},{"title":"Tags","href":"/mcp-tools/tags"},{"title":"Agent chats","href":"/mcp-tools/agent-chats"},{"title":"Community skills","href":"/mcp-tools/community-skills"},{"title":"Webhooks","href":"/mcp-tools/webhooks"},{"title":"Social publishing","href":"/mcp-tools/social-publishing"},{"title":"Analytics","href":"/mcp-tools/analytics"},{"title":"Account","href":"/mcp-tools/account"},{"title":"Billing","href":"/mcp-tools/billing"},{"title":"Support","href":"/mcp-tools/support"}]},{"group":"Editing videos","pages":[{"title":"Batch edits","href":"/mcp-tools/batch-edits"},{"title":"Sources","href":"/mcp-tools/sources"},{"title":"Library","href":"/mcp-tools/library"},{"title":"AI media generation","href":"/mcp-tools/ai-media-generation"},{"title":"Auto Capture","href":"/mcp-tools/auto-capture"},{"title":"Backgrounds","href":"/mcp-tools/backgrounds"},{"title":"Chapters","href":"/mcp-tools/chapters"},{"title":"Clips","href":"/mcp-tools/clips"},{"title":"Layouts","href":"/mcp-tools/layouts"},{"title":"Cropping","href":"/mcp-tools/cropping"},{"title":"Background Music","href":"/mcp-tools/background-music"},{"title":"Zooms","href":"/mcp-tools/zooms"},{"title":"Mouse events","href":"/mcp-tools/mouse-events"},{"title":"Key events","href":"/mcp-tools/key-events"},{"title":"Camera faces","href":"/mcp-tools/camera-faces"},{"title":"Blurs and highlights","href":"/mcp-tools/blurs-and-highlights"},{"title":"Overlays","href":"/mcp-tools/overlays"},{"title":"Text overlays","href":"/mcp-tools/text-overlays"},{"title":"Shape overlays","href":"/mcp-tools/shape-overlays"},{"title":"Sound effects","href":"/mcp-tools/sound-effects"}]},{"group":"Tella Motion","pages":[{"title":"Tella Motion","href":"/mcp-tools/motion"},{"title":"Tella Motion commands","href":"/mcp-tools/motion-commands"},{"title":"Tella Motion properties, easing and fonts","href":"/mcp-tools/motion-values"},{"title":"Tella Motion effects","href":"/mcp-tools/motion-effects"}]}]},{"group":"API Reference","pages":[{"group":"Account","pages":[{"title":"Get the account","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/account","href":"/api-reference/account/get-the-account"}]},{"group":"Agent chats","pages":[{"title":"List a video's agent chats","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/agent-chats","href":"/api-reference/agent-chats/list-a-videos-agent-chats"},{"title":"Start an agent chat","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/agent-chats","href":"/api-reference/agent-chats/start-an-agent-chat"}]},{"group":"Analytics","pages":[{"title":"Get workspace analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics","href":"/api-reference/analytics/get-workspace-analytics"},{"title":"List workspace views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics/views","href":"/api-reference/analytics/list-workspace-views"},{"title":"List a playlist's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}/views","href":"/api-reference/analytics/list-a-playlists-views"},{"title":"Get video analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/analytics","href":"/api-reference/analytics/get-video-analytics"},{"title":"List a video's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/views","href":"/api-reference/analytics/list-a-videos-views"}]},{"group":"Auto Capture","pages":[{"title":"Report an Auto Capture take","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auto-captures/{sourceId}/reports","href":"/api-reference/auto-capture/report-an-auto-capture-take"}]},{"group":"Backgrounds","pages":[{"title":"List available backgrounds","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/backgrounds","href":"/api-reference/backgrounds/list-available-backgrounds"}]},{"group":"Library","pages":[{"title":"List library items","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library","href":"/api-reference/library/list-library-items"},{"title":"Add a source to the library","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library","href":"/api-reference/library/add-a-source-to-the-library"},{"title":"Split an image into layers","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/decompositions","href":"/api-reference/library/split-an-image-into-layers"},{"title":"Generate media with AI","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/generations","href":"/api-reference/library/generate-media-with-ai"},{"title":"Get a generation's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/generations/{id}","href":"/api-reference/library/get-a-generations-status"},{"title":"Import media from a URL","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/imports","href":"/api-reference/library/import-media-from-a-url"},{"title":"Get an import's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/imports/{id}","href":"/api-reference/library/get-an-imports-status"},{"title":"Capture a web page or social post","deprecated":true,"version":null,"openapi":"/openapi.json post /v1/library/screenshots","href":"/api-reference/library/capture-a-web-page-or-social-post"},{"title":"Remove a library item","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/library/{id}","href":"/api-reference/library/remove-a-library-item"}]},{"group":"Tella Motion","pages":[{"title":"Add a Tella Motion clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/clips","href":"/api-reference/tella-motion/add-a-tella-motion-clip"},{"title":"List Tella Motion documents","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents","href":"/api-reference/tella-motion/list-tella-motion-documents"},{"title":"Create a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents","href":"/api-reference/tella-motion/create-a-tella-motion-document"},{"title":"Summarize a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}","href":"/api-reference/tella-motion/summarize-a-tella-motion-document"},{"title":"Edit a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/commands","href":"/api-reference/tella-motion/edit-a-tella-motion-document"},{"title":"Inspect a composition","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/compositions/{compositionId}","href":"/api-reference/tella-motion/inspect-a-composition"},{"title":"Download a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/download","href":"/api-reference/tella-motion/download-a-tella-motion-document"},{"title":"Duplicate a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/duplicate","href":"/api-reference/tella-motion/duplicate-a-tella-motion-document"},{"title":"List a document's media","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/media","href":"/api-reference/tella-motion/list-a-documents-media"},{"title":"Inspect a node's properties","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes","href":"/api-reference/tella-motion/inspect-a-nodes-properties"},{"title":"Get a node's stored fields","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes/raw","href":"/api-reference/tella-motion/get-a-nodes-stored-fields"},{"title":"Get a frame or preview of a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/thumbnail","href":"/api-reference/tella-motion/get-a-frame-or-preview-of-a-tella-motion-document"},{"title":"List Tella Motion effects","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/effects","href":"/api-reference/tella-motion/list-tella-motion-effects"},{"title":"List Tella Motion fonts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/fonts","href":"/api-reference/tella-motion/list-tella-motion-fonts"},{"title":"Get a Tella Motion JSON schema","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/schema","href":"/api-reference/tella-motion/get-a-tella-motion-json-schema"}]},{"group":"Playlist Groups","pages":[{"title":"List playlist groups","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlist-groups","href":"/api-reference/playlist-groups/list-playlist-groups"},{"title":"Create a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlist-groups","href":"/api-reference/playlist-groups/create-a-playlist-group"},{"title":"Delete a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/delete-a-playlist-group"},{"title":"Rename or reorder a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/rename-or-reorder-a-playlist-group"}]},{"group":"Playlists","pages":[{"title":"List all playlists","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists","href":"/api-reference/playlists/list-all-playlists"},{"title":"Create a new playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists","href":"/api-reference/playlists/create-a-new-playlist"},{"title":"Get playlist details","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}","href":"/api-reference/playlists/get-playlist-details"},{"title":"Delete a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}","href":"/api-reference/playlists/delete-a-playlist"},{"title":"Update a playlist","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlists/{id}","href":"/api-reference/playlists/update-a-playlist"},{"title":"Add a video to a playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists/{id}/videos","href":"/api-reference/playlists/add-a-video-to-a-playlist"},{"title":"Remove a video from a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}/videos/{videoId}","href":"/api-reference/playlists/remove-a-video-from-a-playlist"}]},{"group":"Videos","pages":[{"title":"List connected social accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/social-accounts","href":"/api-reference/videos/list-connected-social-accounts"},{"title":"List subtitle presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/subtitle-presets","href":"/api-reference/videos/list-subtitle-presets"},{"title":"Save a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subtitle-presets","href":"/api-reference/videos/save-a-subtitle-preset"},{"title":"List all videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos","href":"/api-reference/videos/list-all-videos"},{"title":"Create a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos","href":"/api-reference/videos/create-a-video"},{"title":"Search videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/search","href":"/api-reference/videos/search-videos"},{"title":"Get video information","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}","href":"/api-reference/videos/get-video-information"},{"title":"Delete a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}","href":"/api-reference/videos/delete-a-video"},{"title":"Update a video","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}","href":"/api-reference/videos/update-a-video"},{"title":"Set background music","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/background-music","href":"/api-reference/videos/set-background-music"},{"title":"Remove background music","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/background-music","href":"/api-reference/videos/remove-background-music"},{"title":"Get the beats of the background music","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/background-music/beats","href":"/api-reference/videos/get-the-beats-of-the-background-music"},{"title":"Download video captions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/captions","href":"/api-reference/videos/download-video-captions"},{"title":"Get video chapters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/chapters","href":"/api-reference/videos/get-video-chapters"},{"title":"Replace video chapters","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/chapters","href":"/api-reference/videos/replace-video-chapters"},{"title":"Add a collaborator to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/collaborators","href":"/api-reference/videos/add-a-collaborator-to-a-video"},{"title":"Generate a document from a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/documents","href":"/api-reference/videos/generate-a-document-from-a-video"},{"title":"Get a generated document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/documents/{documentId}","href":"/api-reference/videos/get-a-generated-document"},{"title":"Duplicate a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/duplicate","href":"/api-reference/videos/duplicate-a-video"},{"title":"Apply many video edits","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/edits","href":"/api-reference/videos/apply-many-video-edits"},{"title":"List video exports","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports","href":"/api-reference/videos/list-video-exports"},{"title":"Start a video export","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/exports","href":"/api-reference/videos/start-a-video-export"},{"title":"Get video export status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports/{exportId}","href":"/api-reference/videos/get-video-export-status"},{"title":"Get a live preview link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/live-preview","href":"/api-reference/videos/get-a-live-preview-link"},{"title":"List social publications","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/publish","href":"/api-reference/videos/list-social-publications"},{"title":"Publish a video to social media","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/publish","href":"/api-reference/videos/publish-a-video-to-social-media"},{"title":"Cancel a scheduled publish","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/publish","href":"/api-reference/videos/cancel-a-scheduled-publish"},{"title":"Get a recording link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/recording-link","href":"/api-reference/videos/get-a-recording-link"},{"title":"Get a video storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/storyboard","href":"/api-reference/videos/get-a-video-storyboard"},{"title":"Apply a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/subtitle-preset","href":"/api-reference/videos/apply-a-subtitle-preset"},{"title":"Get a video thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/thumbnail","href":"/api-reference/videos/get-a-video-thumbnail-or-animated-preview"},{"title":"Set a video's thumbnail","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/thumbnail","href":"/api-reference/videos/set-a-videos-thumbnail"},{"title":"Remove a video's custom thumbnail","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/thumbnail","href":"/api-reference/videos/remove-a-videos-custom-thumbnail"},{"title":"Get a video's timeline","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/timeline","href":"/api-reference/videos/get-a-videos-timeline"}]},{"group":"Sources","pages":[{"title":"Create a source upload (video, audio, image, or LUT)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sources","href":"/api-reference/sources/create-a-source-upload-video-audio-image-or-lut"},{"title":"Get a source's processing status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}","href":"/api-reference/sources/get-a-sources-processing-status"},{"title":"Get the beats of an audio or video source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/beats","href":"/api-reference/sources/get-the-beats-of-an-audio-or-video-source"},{"title":"Get a streaming upload storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/storyboard","href":"/api-reference/sources/get-a-streaming-upload-storyboard"},{"title":"Get a thumbnail of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/thumbnail","href":"/api-reference/sources/get-a-thumbnail-of-a-source-on-no-clip"},{"title":"Get the transcript of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/transcript","href":"/api-reference/sources/get-the-transcript-of-a-source-on-no-clip"},{"title":"Get the audio waveform JSON for a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/waveform","href":"/api-reference/sources/get-the-audio-waveform-json-for-a-source-on-no-clip"}]},{"group":"Tags","pages":[{"title":"List all tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/tags","href":"/api-reference/tags/list-all-tags"},{"title":"Create a new tag","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/tags","href":"/api-reference/tags/create-a-new-tag"},{"title":"Delete a tag","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/tags/{id}","href":"/api-reference/tags/delete-a-tag"},{"title":"Update a tag","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/tags/{id}","href":"/api-reference/tags/update-a-tag"},{"title":"List a video's tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/tags","href":"/api-reference/tags/list-a-videos-tags"},{"title":"Add a tag to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/tags","href":"/api-reference/tags/add-a-tag-to-a-video"},{"title":"Remove a tag from a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/tags/{tagId}","href":"/api-reference/tags/remove-a-tag-from-a-video"}]},{"group":"Clips","pages":[{"title":"List text presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/text-presets","href":"/api-reference/clips/list-text-presets"},{"title":"Save a text preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-presets","href":"/api-reference/clips/save-a-text-preset"},{"title":"Delete a text preset","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/text-presets/{presetId}","href":"/api-reference/clips/delete-a-text-preset"},{"title":"List clips for a video","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips","href":"/api-reference/clips/list-clips-for-a-video"},{"title":"Add a clip from an uploaded source","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips","href":"/api-reference/clips/add-a-clip-from-an-uploaded-source"},{"title":"Get a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/get-a-clip"},{"title":"Delete a clip","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/delete-a-clip"},{"title":"Update a clip","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/update-a-clip"},{"title":"Get audio levels in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/audio-levels","href":"/api-reference/clips/get-audio-levels-in-a-clip"},{"title":"Auto-crop a clip's screen recording","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/auto-crop","href":"/api-reference/clips/auto-crop-a-clips-screen-recording"},{"title":"List blurs on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/list-blurs-on-a-clip"},{"title":"Add a blur to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/add-a-blur-to-a-clip"},{"title":"Remove a blur","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/remove-a-blur"},{"title":"Update a blur","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/update-a-blur"},{"title":"List faces in a clip's camera","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/camera-faces","href":"/api-reference/clips/list-faces-in-a-clips-camera"},{"title":"Cut one or more time ranges from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut","href":"/api-reference/clips/cut-one-or-more-time-ranges-from-a-clip"},{"title":"Cut clip ranges by transcript word indices","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut-by-transcript","href":"/api-reference/clips/cut-clip-ranges-by-transcript-word-indices"},{"title":"Duplicate a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/duplicate","href":"/api-reference/clips/duplicate-a-clip"},{"title":"Get clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/get-clip-color-filters"},{"title":"Set clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/set-clip-color-filters"},{"title":"List highlights on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/list-highlights-on-a-clip"},{"title":"Add a highlight to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/add-a-highlight-to-a-clip"},{"title":"Remove a highlight","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/remove-a-highlight"},{"title":"Update a highlight","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/update-a-highlight"},{"title":"List key presses on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/key-events","href":"/api-reference/clips/list-key-presses-on-a-clip"},{"title":"List layouts on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/list-layouts-on-a-clip"},{"title":"Add a layout to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/add-a-layout-to-a-clip"},{"title":"Remove a layout","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/remove-a-layout"},{"title":"Update a layout","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/update-a-layout"},{"title":"List mouse events on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/mouse-events","href":"/api-reference/clips/list-mouse-events-on-a-clip"},{"title":"List overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/list-overlays-on-a-clip"},{"title":"Add an overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/add-an-overlay-to-a-clip"},{"title":"Remove an overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/remove-an-overlay"},{"title":"Update an overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/update-an-overlay"},{"title":"Remove filler words from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-fillers","href":"/api-reference/clips/remove-filler-words-from-a-clip"},{"title":"Remove silences from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-silences","href":"/api-reference/clips/remove-silences-from-a-clip"},{"title":"Reorder a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/reorder","href":"/api-reference/clips/reorder-a-clip"},{"title":"List shape overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/list-shape-overlays-on-a-clip"},{"title":"Add a shape overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/add-a-shape-overlay-to-a-clip"},{"title":"Remove a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/remove-a-shape-overlay"},{"title":"Update a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/update-a-shape-overlay"},{"title":"Get silent ranges in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/silences","href":"/api-reference/clips/get-silent-ranges-in-a-clip"},{"title":"List sound effects on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/list-sound-effects-on-a-clip"},{"title":"Add a sound effect to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/add-a-sound-effect-to-a-clip"},{"title":"Remove a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/remove-a-sound-effect"},{"title":"Update a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/update-a-sound-effect"},{"title":"List sources for a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources","href":"/api-reference/clips/list-sources-for-a-clip"},{"title":"Get a source thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/thumbnail","href":"/api-reference/clips/get-a-source-thumbnail-or-animated-preview"},{"title":"Get the audio waveform JSON for a source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/waveform","href":"/api-reference/clips/get-the-audio-waveform-json-for-a-source"},{"title":"Split a clip in two","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/split","href":"/api-reference/clips/split-a-clip-in-two"},{"title":"Get a clip storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/storyboard","href":"/api-reference/clips/get-a-clip-storyboard"},{"title":"List text overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/list-text-overlays-on-a-clip"},{"title":"Add a text overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/add-a-text-overlay-to-a-clip"},{"title":"Remove a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/remove-a-text-overlay"},{"title":"Update a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/update-a-text-overlay"},{"title":"Get a clip thumbnail or animated preview","description":"Returns a signed CDN URL for a still image (jpg/png/webp) or animated preview (gif/mp4) of a clip — the rendered composite with the clip's layouts, zooms, and masks. By default returns a 302 redirect to the URL — set `?response=json` to get `{url}` JSON instead. `startTimeMs` is on the clip's playback timeline (cuts applied). `durationMs` only applies to gif/mp4.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/thumbnail","href":"/api-reference/clips/get-a-clip-thumbnail-or-animated-preview"},{"title":"Get clip transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/transcript","href":"/api-reference/clips/get-clip-transcript"},{"title":"Correct transcript words","description":"Correct what a clip's transcript says, one or more words at a time (at most 100 per request). Each edit addresses a word by its transcript `index` and sets either `text` (the corrected wording, which also unhides the word) or `hidden` (whether the word appears in captions and subtitles). Edits change the transcript, captions and subtitles only — never the audio or the clip's timing; use cut-by-transcript to remove spoken words from the video. Visibility and wording are independent: hiding a word preserves any correction made to it. The whole batch is applied atomically as a single transaction, so a request never changes only some of its words. A `500` does not by itself mean nothing changed — the words can land and a later step of the commit still fail — so treat the outcome as either fully applied or not applied at all. Every edit assigns a word outright, so re-sending the identical request is safe and settles it.","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/transcript/words","href":"/api-reference/clips/correct-transcript-words"},{"title":"List zooms on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/list-zooms-on-a-clip"},{"title":"Add a zoom to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/add-a-zoom-to-a-clip"},{"title":"Auto-generate zooms from mouse activity","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms/auto","href":"/api-reference/clips/auto-generate-zooms-from-mouse-activity"},{"title":"Remove a zoom","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/remove-a-zoom"},{"title":"Update a zoom","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/update-a-zoom"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Get endpoint signing secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints/{id}/secret","href":"/api-reference/webhooks/get-endpoint-signing-secret"},{"title":"List recent webhook messages","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages","href":"/api-reference/webhooks/list-recent-webhook-messages"},{"title":"Get a specific webhook message","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages/{id}","href":"/api-reference/webhooks/get-a-specific-webhook-message"}]}]},{"group":"Webhooks","pages":[{"group":"Videos","pages":[{"title":"Document generated","version":null,"deprecated":null,"openapi":"/webhooks.json webhook document.generated","href":"/api-reference/videos/document-generated"},{"title":"Export ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook export.ready","href":"/api-reference/videos/export-ready"},{"title":"Transcript ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook transcript.ready","href":"/api-reference/videos/transcript-ready"},{"title":"Video created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.created","href":"/api-reference/videos/video-created"},{"title":"View milestone reached","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.milestone","href":"/api-reference/videos/view-milestone-reached"},{"title":"Video viewed","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.viewed","href":"/api-reference/videos/video-viewed"}]},{"group":"Playlists","pages":[{"title":"Playlist created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.created","href":"/api-reference/playlists/playlist-created"},{"title":"Video added to playlist","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.video_added","href":"/api-reference/playlists/video-added-to-playlist"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get clip transcript - Tella","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}