Optional identifier supplied by the client to correlate this request with their own logs. When provided, the value is recorded alongside the server-assigned correlation ID in Interhuman logs to aid lookup and support investigations. This header is not echoed back in the response; the server returns its own correlation ID in the X-Correlation-ID HTTP response header.
Optional client SDK identity as <sdk-name>/<semver> (e.g. typescript/0.13.0), sent automatically by the first-party Interhuman SDKs. It is recorded in Interhuman telemetry so SDK adoption and version distribution are visible. The value is self-declared and not authenticated: it never affects authentication, authorization, scopes, quotas, or billing, and a missing, malformed, or unrecognized value is ignored rather than rejected.
Video file to analyze. The video must be at least 3 seconds long and the upload must not exceed 32MB. Accepts the following formats: mp4, avi, mov, mkv, mpeg-ts, webm.
Optional conversation-quality goal dimensions for this interaction. Supplying at least one goal dimension triggers feedback generation. Ignored when conversation_context is supplied — that field then drives feedback generation on its own.
Conversation quality dimensions a caller can flag as a session goal.
The values map one-to-one onto the five CQI quality dimensions defined in
services.cqi.DIMENSION_KEYS:
Optional free-text description of the interaction scenario, role, or communication goal. Used as the sole source of context for feedback generation; goal dimensions are ignored when this context is supplied.
Time-varying engagement state derived from detected engagement signals. Each entry covers a contiguous time window with a single state: 'engaged' when engagement is detected, 'disengaged' when disengagement is detected, 'neutral' otherwise.
Structured interaction feedback returned by the coach model.
Discriminated on type: a feedback result populates message,
active_dimensions, and primary_signal; a no_feedback result
populates reason instead.
Show child attributes
Example:
{ "active_dimensions": ["clarity", "energy"], "message": "You restarted several phrases and looked away near the end, while clarity and energy dropped. Pause, choose one direct sentence, and lead with the main point before adding nuance.", "primary_signal": "hesitation", "type": "feedback" }
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Interhuman AI Beta Docs","colors":{"primary":"#181818","light":"#FFFFFF","dark":"#181818"},"logo":{"light":"https://mintcdn.com/interhuman-beta/bRNugTmIIAU--dK_/logo/light.svg?fit=max\u0026auto=format\u0026n=bRNugTmIIAU--dK_\u0026q=85\u0026s=a2ac910b51ffa3d88106a1fafac12766","dark":"https://mintcdn.com/interhuman-beta/bRNugTmIIAU--dK_/logo/dark.svg?fit=max\u0026auto=format\u0026n=bRNugTmIIAU--dK_\u0026q=85\u0026s=3e10631ff47dcb1edcd4f992ccee75e9"},"favicon":"https://mintcdn.com/interhuman-beta/bRNugTmIIAU--dK_/favicon.svg?fit=max\u0026auto=format\u0026n=bRNugTmIIAU--dK_\u0026q=85\u0026s=c04b02d9b7dab439f5f3662b0c8cc0e9","api":{"openapi":"api-reference/openapi.yaml","asyncapi":"api-reference/asyncapi.yaml","playground":{"display":"interactive"}},"navbar":{"primary":{"type":"button","label":"Interhuman AI","href":"https://interhuman.ai"}},"footer":{"socials":{"x":"https://x.com/InterhumanAI","github":"https://github.com/InterhumanAI","linkedin":"https://www.linkedin.com/company/interhuman-ai"}},"fonts":{"heading":{"family":"Surt","weight":800,"source":"fonts/ATSurt/ATSurt-Regular.woff2","format":"woff2"},"body":{"family":"Surt","weight":400,"source":"fonts/ATSurt/ATSurt-Regular.woff2","format":"woff2"}},"integrations":{"posthog":{"apiKey":"phc_tUGuDKo7PE2SgsVGG0xc4Uc01sqqtsEHu8tgECbPs5u","apiHost":"https://eu.i.posthog.com"}},"contextual":{"options":["copy","view","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"interhuman-beta","hasAudioNarration":false,"actualSubdomain":"interhuman-beta","customDomains":["beta.interhuman.ai"],"gitSource":{"type":"github","owner":"interhuman-core","repo":"interhuman-docs","deployBranch":"beta","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac39196d0030410821c4edc","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Resources","count":11},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"How To","count":5},{"language":"default","tag":"Explanations","count":3},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Updates","count":3},{"language":"default","tag":"Product Updates","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbY2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8-qxTN1OVgaY.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbY2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8-qxTPlOVgaY.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbY2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8-qxTOVOVgaY.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbY2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8-qxTNVOVgaY.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbY2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8-qxTNFOVgaY.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbY2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8-qxTOlOV.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--mint-color-background: #1A1A1A;--mint-color-text: #E2E0DC;--mint-token-keyword: #C181FF;--mint-token-function: #A8FFFC;--mint-token-string: #BBC49E;--mint-token-constant: #E8B4F8;--mint-token-comment: #757575;--mint-token-parameter: #D4B8FF;--mint-token-string-expression: #A8FFFC;--mint-token-punctuation: #8A8880;--mint-token-link: #C181FF}.sidebar-title,.group-title,#sidebar h5,div[class*=\"sidebar\"] h5,.eyebrow,div[class*=\"eyebrow\"]{font-family:'JetBrains Mono', monospace!important;font-weight:500!important;text-transform:uppercase!important;letter-spacing:0.05em}#navbar{}#sidebar{}footer{margin-top:2rem}html:not(.dark) .card:hover,html:not(.dark) a[class*=\"card\"]:hover{border-color:rgba(0, 0, 0, 0.1)!important;background-color:rgba(0, 0, 0, 0.02)!important}html.dark .card:hover,html.dark a[class*=\"card\"]:hover{border-color:rgba(255, 255, 255, 0.2)!important;background-color:rgba(255, 255, 255, 0.05)!important}"}],"page":{"pagePath":"api-reference/upload-analyze","slug":"/api-reference/upload-analyze","pageMetadata":{"title":"Inter-1 Upload Analyze","openapi":"post /v1/upload/analyze","description":"Analyze a video file in upload mode.","href":"/api-reference/upload-analyze"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Analyze a video file in upload mode.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading,ResponseField}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`4`,id:`response-headers`,children:`Response Headers`}),`\n`,_jsxs(ResponseField,{name:`X-Correlation-ID`,type:`header`,id:`param-x-correlation-id`,children:[_jsx(_components.p,{children:`Unique identifier for the request. Include this when contacting support.`}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`f47ac10b-58cc-4372-a567-0e02b2c3d479`})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Inter-1 Upload Analyze","openapi":"post /v1/upload/analyze","description":"Analyze a video file in upload mode.","href":"/api-reference/upload-analyze"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Response Headers","slug":"response-headers","depth":4,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Analyze Upload","description":"Analyze a video file in upload mode.","operationId":"analyze_upload_v1_upload_analyze_post","requestBody":"dfc73adc-861d-4b00-95d3-543e61d15a11","responses":{"200":"9f601618-1ffd-4da5-bc28-e20a96282eed","400":"f263b4a7-0608-46f4-aeae-a5d29f922d6c","401":"41a48e8d-abd8-40ce-ac51-81b0802c1053","403":"d1715d79-d6a8-423f-9b28-3ccf7fa2a812","413":"bf8d3c00-0dc9-4c02-a011-54a91a47950b","422":"3a455131-adb8-4ad5-bfd1-6f897418adde","429":"da75419c-52e8-4230-8420-fab9e207b672","500":"88369bf4-2310-41e3-b058-ac92920a886a"},"security":["cd035843-b1dd-4d53-886a-6930f86aadcd"],"parameters":["c499d347-f729-4021-a249-18b1a172b92c","e170b8f7-da73-4473-bbb1-ddb694a0ae19"],"method":"post","type":"path","servers":["f6548237-80b8-48e7-b96c-b5c539199a40"],"path":"/v1/upload/analyze","baseUrlOptions":["https://api.interhuman.ai"],"title":"Analyze Upload","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c499d347-f729-4021-a249-18b1a172b92c":{"name":"X-Client-Request-Id","in":"header","required":false,"description":"Optional identifier supplied by the client to correlate this request with their own logs. When provided, the value is recorded alongside the server-assigned correlation ID in Interhuman logs to aid lookup and support investigations. This header is not echoed back in the response; the server returns its own correlation ID in the `X-Correlation-ID` HTTP response header.","schema":{"type":"string","title":"X-Client-Request-Id","isRequired":false,"description":"Optional identifier supplied by the client to correlate this request with their own logs. When provided, the value is recorded alongside the server-assigned correlation ID in Interhuman logs to aid lookup and support investigations. This header is not echoed back in the response; the server returns its own correlation ID in the `X-Correlation-ID` HTTP response header.","uniqueKey":"","typeLabel":"string"}},"e170b8f7-da73-4473-bbb1-ddb694a0ae19":{"name":"X-Interhuman-SDK","in":"header","required":false,"description":"Optional client SDK identity as `\u003csdk-name>/\u003csemver>` (e.g. `typescript/0.13.0`), sent automatically by the first-party Interhuman SDKs. It is recorded in Interhuman telemetry so SDK adoption and version distribution are visible. The value is self-declared and not authenticated: it never affects authentication, authorization, scopes, quotas, or billing, and a missing, malformed, or unrecognized value is ignored rather than rejected.","schema":{"type":"string","title":"X-Interhuman-SDK","isRequired":false,"description":"Optional client SDK identity as `\u003csdk-name>/\u003csemver>` (e.g. `typescript/0.13.0`), sent automatically by the first-party Interhuman SDKs. It is recorded in Interhuman telemetry so SDK adoption and version distribution are visible. The value is self-declared and not authenticated: it never affects authentication, authorization, scopes, quotas, or billing, and a missing, malformed, or unrecognized value is ignored rather than rejected.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Video file to analyze. The video must be at least 3 seconds long and the upload must not exceed 32MB. Accepts the following formats: mp4, avi, mov, mkv, mpeg-ts, webm.","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"include[]":{"items":{"type":"string","enum":["conversation_quality_overall","conversation_quality_timeline"],"title":"IncludeFlag","description":"Use these flags to control which conversation quality sections are included in the response.\n\n`conversation_quality_overall`: Include overall conversation quality index.\n`conversation_quality_timeline`: Include conversation quality timeline.","uniqueKey":"include[].items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Include[]","description":"Optional flags indicating which sections should be included in the response. When omitted, no optional sections are included.","default":[],"uniqueKey":"include[]","typeLabel":"enum\u003cstring>[]"},"goal_dimensions[]":{"items":{"type":"string","enum":["clarity","authority","energy","rapport","learning"],"title":"GoalDimension","description":"Conversation quality dimensions a caller can flag as a session goal.\n\nThe values map one-to-one onto the five CQI quality dimensions defined in\n``services.cqi.DIMENSION_KEYS``:\n\n* ``clarity`` — Clarity / Structure\n* ``authority`` — Authority / Credibility\n* ``energy`` — Energy / Presence\n* ``rapport`` — Rapport / Relational Safety\n* ``learning`` — Learning / Exploration","uniqueKey":"goal_dimensions[].items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Goal Dimensions[]","description":"Optional conversation-quality goal dimensions for this interaction. Supplying at least one goal dimension triggers feedback generation. Ignored when `conversation_context` is supplied — that field then drives feedback generation on its own.","default":[],"uniqueKey":"goal_dimensions[]","typeLabel":"enum\u003cstring>[]"},"conversation_context":{"type":"string","title":"Conversation Context","description":"Optional free-text description of the interaction scenario, role, or communication goal. Used as the sole source of context for feedback generation; goal dimensions are ignored when this context is supplied.","default":"","uniqueKey":"conversation_context","typeLabel":"string"}},"type":"object","required":["file"],"title":"Body_analyze_upload_v1_upload_analyze_post","uniqueKey":"","typeLabel":"Body_analyze_upload_v1_upload_analyze_post · object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","include[]":[],"goal_dimensions[]":[],"conversation_context":""}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"9f601618-1ffd-4da5-bc28-e20a96282eed":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"signals":{"items":{"properties":{"type":{"type":"string","enum":["agreement","confidence","confusion","disagreement","disengagement","engagement","frustration","hesitation","interest","skepticism","stress","tension","uncertainty"],"title":"Signal Type","description":"The name of the detected social signal (e.g., 'agreement', 'confusion').","examples":["agreement"],"isRequired":true,"uniqueKey":"signals.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"start":{"type":"number","title":"Start Time","description":"Start time of the signal in seconds relative to the video start.","examples":[10],"isRequired":true,"uniqueKey":"signals.items.[INDEX].start","typeLabel":"number"},"end":{"type":"number","title":"End Time","description":"End time of the signal in seconds relative to the video start.","examples":[15],"isRequired":true,"uniqueKey":"signals.items.[INDEX].end","typeLabel":"number"},"probability":{"oneOf":[{"type":"string","title":"Probability","description":"Signal probability levels.","enum":["high","medium","low"],"example":"high","uniqueKey":"signals.items.[INDEX].probability.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Probability","description":"Confidence level of the detected signal: high, medium, or low.","example":"high","uniqueKey":"signals.items.[INDEX].probability.oneOf.1","typeLabel":"null"}],"uniqueKey":"signals.items.[INDEX].probability","typeLabel":"enum\u003cstring> | null"},"rationale":{"oneOf":[{"type":"string","title":"Rationale","description":"A concise, evidence-based explanation of why the signal was detected. Grounded in observable cues from the video.","example":"Subject nodded repeatedly while maintaining eye contact.","uniqueKey":"signals.items.[INDEX].rationale.oneOf.0","typeLabel":"string"},{"type":"null","title":"Rationale","description":"A concise, evidence-based explanation of why the signal was detected. Grounded in observable cues from the video.","example":"Subject nodded repeatedly while maintaining eye contact.","uniqueKey":"signals.items.[INDEX].rationale.oneOf.1","typeLabel":"null"}],"uniqueKey":"signals.items.[INDEX].rationale","typeLabel":"string | null"},"modality":{"items":{"type":"string","uniqueKey":"signals.items.[INDEX].modality.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Modality","description":"Analysis modalities that detected this signal, naming the source of the evidence. When several tracks detect the same signal, every contributing modality is included.","examples":[["video"]],"uniqueKey":"signals.items.[INDEX].modality","typeLabel":"string[]"}},"type":"object","required":["type","start","end"],"title":"Signal","description":"Detected signal.","uniqueKey":"signals.items.[INDEX]","typeLabel":"Signal · object"},"type":"array","title":"Signals","description":"List of all social signals detected in the analyzed video.","examples":[[{"end":10,"probability":"high","rationale":"Subject nodded repeatedly while maintaining eye contact.","start":0,"type":"agreement"},{"end":15,"probability":"medium","rationale":"Steady voice with minimal hesitation.","start":5,"type":"confidence"}]],"isRequired":true,"uniqueKey":"signals","typeLabel":"Signal · object[]"},"engagement_state":{"items":{"properties":{"state":{"type":"string","enum":["engaged","neutral","disengaged"],"title":"State","description":"The engagement level for this time window.","examples":["engaged"],"isRequired":true,"uniqueKey":"engagement_state.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"start":{"type":"number","title":"Start Time","description":"Start time in seconds relative to the video start.","examples":[0],"isRequired":true,"uniqueKey":"engagement_state.items.[INDEX].start","typeLabel":"number"},"end":{"type":"number","title":"End Time","description":"End time in seconds relative to the video start.","examples":[5],"isRequired":true,"uniqueKey":"engagement_state.items.[INDEX].end","typeLabel":"number"}},"type":"object","required":["state","start","end"],"title":"EngagementStateEntry","description":"A contiguous time window with a single engagement state.","uniqueKey":"engagement_state.items.[INDEX]","typeLabel":"EngagementStateEntry · object"},"type":"array","title":"Engagement State","description":"Time-varying engagement state derived from detected engagement signals. Each entry covers a contiguous time window with a single state: 'engaged' when engagement is detected, 'disengaged' when disengagement is detected, 'neutral' otherwise.","examples":[[{"end":5,"start":0,"state":"engaged"},{"end":15,"start":5,"state":"neutral"}]],"uniqueKey":"engagement_state","typeLabel":"EngagementStateEntry · object[]"},"feedback":{"oneOf":[{"type":"object","title":"InteractionFeedback","description":"Structured interaction feedback returned by the coach model.\n\nDiscriminated on ``type``: a ``feedback`` result populates ``message``,\n``active_dimensions``, and ``primary_signal``; a ``no_feedback`` result\npopulates ``reason`` instead.","required":["type"],"example":{"active_dimensions":["clarity","energy"],"message":"You restarted several phrases and looked away near the end, while clarity and energy dropped. Pause, choose one direct sentence, and lead with the main point before adding nuance.","primary_signal":"hesitation","type":"feedback"},"properties":{"type":{"type":"string","enum":["feedback","no_feedback"],"title":"Type","description":"Whether a feedback message was produced or skipped for lack of evidence.","examples":["feedback"],"isRequired":true,"uniqueKey":"feedback.oneOf.0.type","typeLabel":"enum\u003cstring>"},"message":{"oneOf":[{"type":"string","title":"Message","description":"The single concise feedback message with one concrete next step. Present when `type` is `feedback`.","example":"You restarted several phrases and looked away near the end, while clarity dropped. Pause, choose one direct sentence, and lead with the main point.","uniqueKey":"feedback.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"The single concise feedback message with one concrete next step. Present when `type` is `feedback`.","example":"You restarted several phrases and looked away near the end, while clarity dropped. Pause, choose one direct sentence, and lead with the main point.","uniqueKey":"feedback.oneOf.0.message.oneOf.1","typeLabel":"null"}],"uniqueKey":"feedback.oneOf.0.message","typeLabel":"string | null"},"active_dimensions":{"items":{"type":"string","enum":["clarity","authority","energy","rapport","learning"],"title":"GoalDimension","description":"Conversation quality dimensions a caller can flag as a session goal.\n\nThe values map one-to-one onto the five CQI quality dimensions defined in\n``services.cqi.DIMENSION_KEYS``:\n\n* ``clarity`` — Clarity / Structure\n* ``authority`` — Authority / Credibility\n* ``energy`` — Energy / Presence\n* ``rapport`` — Rapport / Relational Safety\n* ``learning`` — Learning / Exploration","uniqueKey":"feedback.oneOf.0.active_dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Active Dimensions","description":"The active goal dimensions the coach used to ground the feedback. Populated when `type` is `feedback`.","examples":[["clarity","energy"]],"uniqueKey":"feedback.oneOf.0.active_dimensions","typeLabel":"enum\u003cstring>[]"},"primary_signal":{"oneOf":[{"type":"string","title":"SignalType","description":"Enumeration of supported social signals.","enum":["agreement","confidence","confusion","disagreement","disengagement","engagement","frustration","hesitation","interest","skepticism","stress","tension","uncertainty"],"example":"hesitation","uniqueKey":"feedback.oneOf.0.primary_signal.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Primary Signal","description":"The main social signal the feedback is built around. Present when `type` is `feedback` and a primary signal was chosen.","example":"hesitation","uniqueKey":"feedback.oneOf.0.primary_signal.oneOf.1","typeLabel":"null"}],"uniqueKey":"feedback.oneOf.0.primary_signal","typeLabel":"enum\u003cstring> | null"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"A brief reason why no feedback was produced. Present when `type` is `no_feedback`.","example":"No signals relevant to the active goal dimensions were detected.","uniqueKey":"feedback.oneOf.0.reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"A brief reason why no feedback was produced. Present when `type` is `no_feedback`.","example":"No signals relevant to the active goal dimensions were detected.","uniqueKey":"feedback.oneOf.0.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"feedback.oneOf.0.reason","typeLabel":"string | null"}},"uniqueKey":"feedback.oneOf.0","typeLabel":"InteractionFeedback · object"},{"type":"null","title":"Feedback","description":"Structured interaction feedback generated from the detected signals and conversation quality. Present only when feedback is enabled and either a `conversation_context` or at least one goal dimension was supplied. A `feedback` result carries a `message` plus the `active_dimensions` and `primary_signal` it was grounded in; a `no_feedback` result carries a `reason` instead.","example":{"active_dimensions":["clarity","energy"],"message":"You restarted several phrases and looked away near the end, while clarity and energy dropped. Pause, choose one direct sentence, and lead with the main point before adding nuance.","primary_signal":"hesitation","type":"feedback"},"uniqueKey":"feedback.oneOf.1","typeLabel":"null"}],"uniqueKey":"feedback","typeLabel":"InteractionFeedback · object | null"},"conversation_quality":{"oneOf":[{"type":"object","title":"ConversationQuality","description":"Conversation quality Index with optional overall and time-varying scores.\n\nUse the Include flags in the request to control which conversation quality\nsections are included in the response.","required":["overall","timeline"],"example":{"overall":{"authority":68,"clarity":67,"energy":80,"learning":70,"quality_index":72,"rapport":75},"timeline":[{"end":10,"start":0,"values":{"authority":70,"clarity":69,"energy":78,"learning":68,"quality_index":70,"rapport":77}},{"end":20,"start":10,"values":{"authority":65,"clarity":65,"energy":82,"learning":72,"quality_index":74,"rapport":73}}]},"properties":{"overall":{"properties":{"quality_index":{"type":"number","title":"Quality Index","description":"Overall conversation quality index (0-100). Mean of the five dimension scores.","examples":[72],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.overall.quality_index","typeLabel":"number"},"clarity":{"type":"number","title":"Clarity","description":"Clarity / Structure dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[67],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.overall.clarity","typeLabel":"number"},"authority":{"type":"number","title":"Authority","description":"Authority / Credibility dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[68],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.overall.authority","typeLabel":"number"},"energy":{"type":"number","title":"Energy","description":"Energy / Presence dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[80],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.overall.energy","typeLabel":"number"},"rapport":{"type":"number","title":"Rapport","description":"Rapport / Relational Safety dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[75],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.overall.rapport","typeLabel":"number"},"learning":{"type":"number","title":"Learning","description":"Learning / Exploration dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[70],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.overall.learning","typeLabel":"number"}},"type":"object","required":["quality_index","clarity","authority","energy","rapport","learning"],"title":"Overall","description":"Aggregated conversation quality scores for the entire conversation. Added when `conversation_quality_overall` is included in the Include flags.","isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.overall","typeLabel":"Overall · object"},"timeline":{"items":{"properties":{"start":{"type":"number","title":"Start Time","description":"Window start time in seconds, in absolute session-cumulative time.","examples":[0],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].start","typeLabel":"number"},"end":{"type":"number","title":"End Time","description":"Window end time in seconds, in absolute session-cumulative time.","examples":[10],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].end","typeLabel":"number"},"values":{"properties":{"quality_index":{"type":"number","title":"Quality Index","description":"Overall conversation quality index (0-100). Mean of the five dimension scores.","examples":[72],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].values.quality_index","typeLabel":"number"},"clarity":{"type":"number","title":"Clarity","description":"Clarity / Structure dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[67],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].values.clarity","typeLabel":"number"},"authority":{"type":"number","title":"Authority","description":"Authority / Credibility dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[68],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].values.authority","typeLabel":"number"},"energy":{"type":"number","title":"Energy","description":"Energy / Presence dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[80],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].values.energy","typeLabel":"number"},"rapport":{"type":"number","title":"Rapport","description":"Rapport / Relational Safety dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[75],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].values.rapport","typeLabel":"number"},"learning":{"type":"number","title":"Learning","description":"Learning / Exploration dimension score (0-100). Returns 50 when no diagnostic evidence is available for this dimension.","examples":[70],"isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].values.learning","typeLabel":"number"}},"type":"object","required":["quality_index","clarity","authority","energy","rapport","learning"],"title":"Values","description":"Conversation quality dimension scores for this time window.","isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX].values","typeLabel":"Values · object"}},"type":"object","required":["start","end","values"],"title":"ConversationQualityTimelineEntry","description":"Conversation quality values for a single time window in the timeline.","uniqueKey":"conversation_quality.oneOf.0.timeline.items.[INDEX]","typeLabel":"ConversationQualityTimelineEntry · object"},"type":"array","title":"Timeline","description":"Time-varying conversation quality scores in consecutive, non-overlapping windows. Added when `conversation_quality_timeline` is included in the Include flags.","isRequired":true,"uniqueKey":"conversation_quality.oneOf.0.timeline","typeLabel":"ConversationQualityTimelineEntry · object[]"}},"uniqueKey":"conversation_quality.oneOf.0","typeLabel":"ConversationQuality · object"},{"type":"null","title":"Conversation Quality","description":"Conversation quality with overall and time-varying scores. Present whenever it is explicitly requested via the include[] parameter — including when all signals are neutral or no signals were detected, in which case scores fall back to the neutral midpoint of 50. When present, every dimension score and the overall quality index are guaranteed to be numeric (50 indicates no diagnostic evidence for that dimension).","example":{"overall":{"authority":68,"clarity":67,"energy":80,"learning":70,"quality_index":72,"rapport":75},"timeline":[{"end":10,"start":0,"values":{"authority":70,"clarity":69,"energy":78,"learning":68,"quality_index":70,"rapport":77}},{"end":20,"start":10,"values":{"authority":65,"clarity":65,"energy":82,"learning":72,"quality_index":74,"rapport":73}}]},"uniqueKey":"conversation_quality.oneOf.1","typeLabel":"null"}],"uniqueKey":"conversation_quality","typeLabel":"ConversationQuality · object | null"}},"type":"object","required":["signals"],"title":"AnalysisResult","description":"Contains the result of the video analysis.","uniqueKey":"","typeLabel":"AnalysisResult · object"},"example":{"signals":[{"type":"agreement","start":0,"end":10,"probability":"high","rationale":"Subject nodded repeatedly while maintaining eye contact."},{"type":"confidence","start":5,"end":15,"probability":"medium","rationale":"Steady voice with minimal hesitation."}],"engagement_state":[{"start":0,"end":5,"state":"engaged"},{"start":5,"end":15,"state":"neutral"}],"conversation_quality":{"overall":{"quality_index":72,"clarity":67,"authority":68,"energy":80,"rapport":75,"learning":70},"timeline":[{"start":0,"end":10,"values":{"quality_index":70,"clarity":69,"authority":70,"energy":78,"rapport":77,"learning":68}},{"start":10,"end":20,"values":{"quality_index":74,"clarity":65,"authority":65,"energy":82,"rapport":73,"learning":72}}]}},"examples":{"Example":{"title":"Example","value":{"signals":[{"type":"agreement","start":0,"end":10,"probability":"high","rationale":"Subject nodded repeatedly while maintaining eye contact."},{"type":"confidence","start":5,"end":15,"probability":"medium","rationale":"Steady voice with minimal hesitation."}],"engagement_state":[{"start":0,"end":5,"state":"engaged"},{"start":5,"end":15,"state":"neutral"}],"conversation_quality":{"overall":{"quality_index":72,"clarity":67,"authority":68,"energy":80,"rapport":75,"learning":70},"timeline":[{"start":0,"end":10,"values":{"quality_index":70,"clarity":69,"authority":70,"energy":78,"rapport":77,"learning":68}},{"start":10,"end":20,"values":{"quality_index":74,"clarity":65,"authority":65,"energy":82,"rapport":73,"learning":72}}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"f263b4a7-0608-46f4-aeae-a5d29f922d6c":{"description":"Bad request. The video file is missing (ih4001), too short (ih4007), or a request parameter is invalid (ih4005).","content":{"application/json":{"schema":{"properties":{"error_id":{"type":"string","title":"Error Id","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error_id","typeLabel":"string"},"correlation_id":{"oneOf":[{"type":"string","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"correlation_id","typeLabel":"string | null"},"link":{"oneOf":[{"type":"string","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.0","typeLabel":"string"},{"type":"null","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"type":"object","required":["error_id"],"title":"ErrorResponse","description":"Structured error returned by all HTTP error paths.\n\nOnly ``error_id`` is required. The other fields are included when available.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"error_id":"ih4001","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih4001-missing-video-file","message":"No video file provided. Include the video as a multipart/form-data field named 'file'."},"examples":{"Example":{"title":"Example","value":{"error_id":"ih4001","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih4001-missing-video-file","message":"No video file provided. Include the video as a multipart/form-data field named 'file'."}}},"exampleType":"examples"}},"exampleType":"examples"},"41a48e8d-abd8-40ce-ac51-81b0802c1053":{"description":"Unauthorized. The API key is missing (ih2002) or the credentials are invalid (ih2001).","content":{"application/json":{"schema":{"properties":{"error_id":{"type":"string","title":"Error Id","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error_id","typeLabel":"string"},"correlation_id":{"oneOf":[{"type":"string","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"correlation_id","typeLabel":"string | null"},"link":{"oneOf":[{"type":"string","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.0","typeLabel":"string"},{"type":"null","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"type":"object","required":["error_id"],"title":"ErrorResponse","description":"Structured error returned by all HTTP error paths.\n\nOnly ``error_id`` is required. The other fields are included when available.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"error_id":"ih2002","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih2002-missing-credentials","message":"No authentication credentials were provided. Include your API key in the 'Authorization: Bearer \u003capi_key>' header (or, for WebSocket connections, as the 'Sec-WebSocket-Protocol: access_token, \u003capi_key>' subprotocol pair)."},"examples":{"Example":{"title":"Example","value":{"error_id":"ih2002","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih2002-missing-credentials","message":"No authentication credentials were provided. Include your API key in the 'Authorization: Bearer \u003capi_key>' header (or, for WebSocket connections, as the 'Sec-WebSocket-Protocol: access_token, \u003capi_key>' subprotocol pair)."}}},"exampleType":"examples"}},"exampleType":"examples"},"d1715d79-d6a8-423f-9b28-3ccf7fa2a812":{"description":"Forbidden. The API key does not include the required scope (ih2003).","content":{"application/json":{"schema":{"properties":{"error_id":{"type":"string","title":"Error Id","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error_id","typeLabel":"string"},"correlation_id":{"oneOf":[{"type":"string","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"correlation_id","typeLabel":"string | null"},"link":{"oneOf":[{"type":"string","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.0","typeLabel":"string"},{"type":"null","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"type":"object","required":["error_id"],"title":"ErrorResponse","description":"Structured error returned by all HTTP error paths.\n\nOnly ``error_id`` is required. The other fields are included when available.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"error_id":"ih2003","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih2003-insufficient-scope","message":"Insufficient scope. This endpoint requires the 'interhumanai.upload' scope."},"examples":{"Example":{"title":"Example","value":{"error_id":"ih2003","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih2003-insufficient-scope","message":"Insufficient scope. This endpoint requires the 'interhumanai.upload' scope."}}},"exampleType":"examples"}},"exampleType":"examples"},"bf8d3c00-0dc9-4c02-a011-54a91a47950b":{"description":"Payload too large. The video file exceeds the maximum upload size (ih4003).","content":{"application/json":{"schema":{"properties":{"error_id":{"type":"string","title":"Error Id","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error_id","typeLabel":"string"},"correlation_id":{"oneOf":[{"type":"string","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"correlation_id","typeLabel":"string | null"},"link":{"oneOf":[{"type":"string","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.0","typeLabel":"string"},{"type":"null","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"type":"object","required":["error_id"],"title":"ErrorResponse","description":"Structured error returned by all HTTP error paths.\n\nOnly ``error_id`` is required. The other fields are included when available.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"error_id":"ih4003","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih4003-file-too-large","message":"Payload too large. The video file must not exceed 32.0 MB."},"examples":{"Example":{"title":"Example","value":{"error_id":"ih4003","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih4003-file-too-large","message":"Payload too large. The video file must not exceed 32.0 MB."}}},"exampleType":"examples"}},"exampleType":"examples"},"3a455131-adb8-4ad5-bfd1-6f897418adde":{"description":"Unprocessable video. The file is empty (ih5001), corrupted (ih5002), uses an unsupported codec (ih5003), has a malformed segment (ih5004), exceeds segment size limits (ih5005), contains a segment that is too short (ih5006), or was rejected by the model (ih5007).","content":{"application/json":{"schema":{"properties":{"error_id":{"type":"string","title":"Error Id","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error_id","typeLabel":"string"},"correlation_id":{"oneOf":[{"type":"string","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"correlation_id","typeLabel":"string | null"},"link":{"oneOf":[{"type":"string","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.0","typeLabel":"string"},{"type":"null","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"type":"object","required":["error_id"],"title":"ErrorResponse","description":"Structured error returned by all HTTP error paths.\n\nOnly ``error_id`` is required. The other fields are included when available.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"error_id":"ih5001","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih5001-empty-video","message":"Unable to process the video: the file appears to be empty or contains no video content."},"examples":{"Example":{"title":"Example","value":{"error_id":"ih5001","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih5001-empty-video","message":"Unable to process the video: the file appears to be empty or contains no video content."}}},"exampleType":"examples"}},"exampleType":"examples"},"da75419c-52e8-4230-8420-fab9e207b672":{"description":"Too many requests or quota exceeded. The client has exceeded the rate limit (ih3001), the account has hit its concurrent-request limit (ih3002), or the account has reached its usage limit (ih3003).","content":{"application/json":{"schema":{"properties":{"error_id":{"type":"string","title":"Error Id","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error_id","typeLabel":"string"},"correlation_id":{"oneOf":[{"type":"string","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"correlation_id","typeLabel":"string | null"},"link":{"oneOf":[{"type":"string","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.0","typeLabel":"string"},{"type":"null","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"type":"object","required":["error_id"],"title":"ErrorResponse","description":"Structured error returned by all HTTP error paths.\n\nOnly ``error_id`` is required. The other fields are included when available.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"rate_limit":{"title":"rate_limit","value":{"error_id":"ih3001","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih3001-rate-limit-exceeded","message":"Rate limit exceeded. You have sent too many requests. Please wait 60 seconds before retrying."}},"concurrent_request_limit":{"title":"concurrent_request_limit","value":{"error_id":"ih3002","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih3002-concurrent-request-limit","message":"Concurrent request limit exceeded. You have 5 active requests; the maximum is 5. Wait for an active request to complete before submitting another."}},"quota_exceeded":{"title":"quota_exceeded","value":{"error_id":"ih3003","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih3003-quota-exceeded","message":"Quota exceeded. Your account has reached its usage limit. Contact support to upgrade your plan, add credits, or wait for the quota to reset."}}},"exampleType":"examples"}},"exampleType":"examples"},"88369bf4-2310-41e3-b058-ac92920a886a":{"description":"Internal server error (ih1001) or the upstream AI service is temporarily unavailable (ih1002).","content":{"application/json":{"schema":{"properties":{"error_id":{"type":"string","title":"Error Id","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"error_id","typeLabel":"string"},"correlation_id":{"oneOf":[{"type":"string","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Correlation Id","description":"Unique identifier assigned to each API request or WebSocket connection. It allows both the client and the service to trace a specific interaction through logs and internal systems. If you contact support about a particular request or connection, providing the correlation_id allows the team to locate the relevant records quickly. Clients who may later request deletion of data for privacy reasons should store the correlation_id, as it can be used to identify and remove data associated with that specific interaction.","uniqueKey":"correlation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"correlation_id","typeLabel":"string | null"},"link":{"oneOf":[{"type":"string","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.0","typeLabel":"string"},{"type":"null","title":"Link","description":"URL to additional information about this error.","uniqueKey":"link.oneOf.1","typeLabel":"null"}],"uniqueKey":"link","typeLabel":"string | null"},"message":{"oneOf":[{"type":"string","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message","description":"Error explanation. Contains any additional details about the specific error that was encountered.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"type":"object","required":["error_id"],"title":"ErrorResponse","description":"Structured error returned by all HTTP error paths.\n\nOnly ``error_id`` is required. The other fields are included when available.","uniqueKey":"","typeLabel":"ErrorResponse · object"},"example":{"error_id":"ih1001","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih1001-internal-server-error","message":"Internal server error. Please try again or contact support if the problem persists."},"examples":{"Example":{"title":"Example","value":{"error_id":"ih1001","correlation_id":"550e8400-e29b-41d4-a716-446655440000","link":"https://docs.interhuman.ai/api-reference/error-handling#ih1001-internal-server-error","message":"Internal server error. Please try again or contact support if the problem persists."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"cd035843-b1dd-4d53-886a-6930f86aadcd":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key authentication. Include your API key in the Authorization header as 'Bearer \u003capi_key>'.","scopes":[]}}},"servers":{"f6548237-80b8-48e7-b96c-b5c539199a40":{"url":"https://api.interhuman.ai","description":"Production environment"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key authentication. Include your API key in the Authorization header as 'Bearer \u003capi_key>'.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key authentication. Include your API key in the Authorization header as 'Bearer \u003capi_key>'.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"interhuman-beta","siteName":"Interhuman AI Beta Docs","title":"Inter-1 Upload Analyze - Interhuman AI Beta Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T12:01:35.484Z","originalFileLocation":"api-reference/upload-analyze.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=\"Analyze a video file in upload mode.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Interhuman AI Beta Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Inter-1 Upload Analyze - Interhuman AI Beta Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Analyze a video file in upload mode.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Interhuman AI Beta Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://beta.interhuman.ai/api-reference/upload-analyze\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://interhuman-beta.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Inter-1+Upload+Analyze\u0026amp;description=Analyze+a+video+file+in+upload+mode.\u0026amp;theme=7946f56383c9e9e1521696a1\u0026amp;signature=f6db2150c7ae81b644e62f07b17323314fd30ad187f87513e62fc864a6dcb0ee\">\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=\"Inter-1 Upload Analyze - Interhuman AI Beta Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Analyze a video file in upload mode.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://interhuman-beta.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Inter-1+Upload+Analyze\u0026amp;description=Analyze+a+video+file+in+upload+mode.\u0026amp;theme=7946f56383c9e9e1521696a1\u0026amp;signature=f6db2150c7ae81b644e62f07b17323314fd30ad187f87513e62fc864a6dcb0ee\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/interhuman-beta/4yFtPKYlGGYxpzuZ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Interhuman AI Beta Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#181818\">\u003clink data-mint-head rel=\"canonical\" href=\"https://beta.interhuman.ai/api-reference/upload-analyze\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/upload-analyze.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://beta.interhuman.ai/#organization\",\"name\":\"Interhuman AI Beta Docs\",\"url\":\"https://beta.interhuman.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/interhuman-beta/bRNugTmIIAU--dK_/logo/light.svg?fit=max\u0026auto=format\u0026n=bRNugTmIIAU--dK_\u0026q=85\u0026s=a2ac910b51ffa3d88106a1fafac12766\"}},{\"@type\":\"WebSite\",\"@id\":\"https://beta.interhuman.ai#website\",\"name\":\"Interhuman AI Beta Docs\",\"url\":\"https://beta.interhuman.ai\",\"publisher\":{\"@id\":\"https://beta.interhuman.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://beta.interhuman.ai/api-reference/upload-analyze#webpage\",\"url\":\"https://beta.interhuman.ai/api-reference/upload-analyze\",\"name\":\"Inter-1 Upload Analyze\",\"description\":\"Analyze a video file in upload mode.\",\"dateModified\":\"2026-10-05T12:01:35.484Z\",\"isPartOf\":{\"@id\":\"https://beta.interhuman.ai#website\"},\"breadcrumb\":{\"@id\":\"https://beta.interhuman.ai/api-reference/upload-analyze#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://beta.interhuman.ai/api-reference/upload-analyze#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Resources\",\"item\":\"https://beta.interhuman.ai/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Inter-1 Upload Analyze\",\"item\":\"https://beta.interhuman.ai/api-reference/upload-analyze\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://beta.interhuman.ai/api-reference/upload-analyze#apireference\",\"headline\":\"Inter-1 Upload Analyze\",\"name\":\"Inter-1 Upload Analyze\",\"description\":\"Analyze a video file in upload mode.\",\"url\":\"https://beta.interhuman.ai/api-reference/upload-analyze\",\"mainEntityOfPage\":{\"@id\":\"https://beta.interhuman.ai/api-reference/upload-analyze#webpage\"},\"dateModified\":\"2026-10-05T12:01:35.484Z\",\"publisher\":{\"@id\":\"https://beta.interhuman.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://beta.interhuman.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Interhuman AI Beta Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Interhuman AI Beta Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/upload-analyze.md","siteName":"Interhuman AI Beta Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"API Reference","groups":[{"group":"Resources","icon":"layer-group","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Client Tokens","openapi":"post /v1/client_tokens","description":"Mint a short-lived, capped client token for direct browser use. Call this server-side with your API key; the returned token grants the requested scopes (default 'interhumanai.stream') and can be handed to a browser to call the upload and realtime endpoints — e.g. POST /v1/upload/analyze, or open wss://.../v1/stream/analyze with the 'Sec-WebSocket-Protocol: access_token, \u003ctoken>' subprotocol pair (a supported alternative to the 'Authorization' header, for browsers that cannot set it). The embedded caps are enforced by the API across all three (the video budget spans upload, stream, and realtime).","href":"/api-reference/client-tokens"},{"title":"Inter-1 Upload Analyze","openapi":"post /v1/upload/analyze","href":"/api-reference/upload-analyze"},{"title":"Inter-1 Streaming Analyze","asyncapi":"stream_analyze_v1","description":"Analyze a video stream.","href":"/api-reference/stream-analyze"},{"title":"Inter-1 Realtime Analyze","asyncapi":"realtime_analyze_v1","href":"/api-reference/realtime-analyze"},{"title":"Inter-2 Upload Analyze","openapi":"post /v2/upload/analyze","href":"/api-reference/upload-analyze-v2"},{"title":"Inter-2 Streaming Analyze","asyncapi":"stream_analyze_v2","href":"/api-reference/stream-analyze-v2"},{"title":"TypeScript SDK","href":"/sdk-reference/typescript-sdk"},{"title":"Python SDK","href":"/sdk-reference/python-sdk"},{"title":"Error handling","href":"/api-reference/error-handling"}]}]},{"tab":"Updates","pages":[{"title":"Updates","href":"/updates/changelog"}]}]},"basePath":"","title":"Inter-1 Upload Analyze - Interhuman AI Beta Docs","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","Page-1CZdsdAn.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}