Submit video URLs with one shared set of annotation options. A successful response returns 202, a batch ID, and job IDs in input order. Media validation and annotation happen asynchronously.Use one Idempotency-Key for each intended batch. Keys are scoped to your organization. Repeat the same key and request to recover an accepted batch; a changed request with that key returns 409. See submission and replay examples.For authentication, limits, and HTTP errors, see the workflow and error guide.
Accepted job identifiers in the same order as the submitted inputs.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Perceptron Docs","colors":{"primary":"#3B63FF","light":"#8BA6FF","dark":"#193BFF"},"logo":{"light":"https://mintcdn.com/perceptron/CuyGah1e2BqRrsVm/logo/perceptron-full-logo-light.svg?fit=max\u0026auto=format\u0026n=CuyGah1e2BqRrsVm\u0026q=85\u0026s=f5d2ffd0aaf71daba362f13fc9f7decf","dark":"https://mintcdn.com/perceptron/CuyGah1e2BqRrsVm/logo/perceptron-full-logo-dark.svg?fit=max\u0026auto=format\u0026n=CuyGah1e2BqRrsVm\u0026q=85\u0026s=859b1eeb3fa33674275135e6590684df"},"favicon":{"light":"https://mintcdn.com/perceptron/h8MQ12qmkOCPxnyY/logo/favicon_light.png?fit=max\u0026auto=format\u0026n=h8MQ12qmkOCPxnyY\u0026q=85\u0026s=9fed764e4a310a0a735776364bae108f","dark":"https://mintcdn.com/perceptron/h8MQ12qmkOCPxnyY/logo/favicon_dark.png?fit=max\u0026auto=format\u0026n=h8MQ12qmkOCPxnyY\u0026q=85\u0026s=c3ee1fadf844c0278101787211ea413c"},"api":{"openapi":{"source":"api-reference/openapi.json","directory":"api-reference"},"mdx":{"auth":{"method":"bearer"}}},"navbar":{"links":[{"href":"https://www.perceptron.inc/demo","label":"Demo"},{"href":"mailto:support@perceptron.inc","label":"Support"},{"href":"https://discord.gg/fgBeaACQzE","label":"Discord"}]},"footer":{"socials":{"discord":"https://discord.gg/fgBeaACQzE","github":"https://github.com/perceptron-ai-inc","linkedin":"https://www.linkedin.com/company/perceptron-ai-inc","x":"https://x.com/perceptroninc"}},"contextual":{"options":["copy","chatgpt","claude","cursor","mcp","perplexity","view","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"perceptron","hasAudioNarration":false,"actualSubdomain":"perceptron","customDomains":["docs.perceptron.inc"],"gitSource":{"type":"github","owner":"perceptron-ai-inc","repo":"mintlify_docs","deployBranch":"production","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab61f6fc6fb6f41c7bf742a","collectionId":"47c4f240-aa64-46f0-a5e2-b4675a405dae","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab61f6fc6fb6f41c7bf742a"},"entitlements":{},"buildId":"6aeb0a42c8520f7b8ee1fd76","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Models","count":74},{"language":"default","tag":"Perceptron Mk1.5","count":60},{"language":"default","tag":"Perceptron Mk1","count":46},{"language":"default","tag":"API reference","count":38},{"language":"default","tag":"Capabilities","count":28},{"language":"default","tag":"Developer guides","count":23},{"language":"default","tag":"Services","count":21},{"language":"default","tag":"Egocentric","count":16},{"language":"default","tag":"Python SDK","count":12},{"language":"default","tag":"Image","count":11}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"ABCArizonaFlare\";font-style:normal;font-weight:400;font-display:swap;src:url(/fonts/ABCArizonaFlare/ABCArizonaFlare-Regular-Trial.woff2) format(\"woff2\")}#page-title,.api-endpoint h3,.api-section h2,.mdx-content h1,.mdx-content h2,.page-title{font-family:\"ABCArizonaFlare\";font-weight:400}.h-5,h5{text-transform:uppercase;font-size:.85rem}"}],"page":{"pagePath":"api-reference/egocentric/submit-an-egocentric-batch","slug":"/api-reference/egocentric/submit-an-egocentric-batch","pageMetadata":{"title":"Submit an egocentric batch","description":"Submit an egocentric batch with the Egocentric API.","openapi":"api-reference/openapi.json POST /v1/egocentric/batches","href":"/api-reference/egocentric/submit-an-egocentric-batch"},"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: \"Submit an egocentric batch with the Egocentric API.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Submit video URLs with one shared set of annotation options. A successful response returns `,_jsx(_components.code,{children:`202`}),`, a batch ID, and job IDs in input order. Media validation and annotation happen asynchronously.`]}),`\n`,_jsxs(_components.p,{children:[`Use one `,_jsx(_components.code,{children:`Idempotency-Key`}),` for each intended batch. Keys are scoped to your organization. Repeat the same key and request to recover an accepted batch; a changed request with that key returns `,_jsx(_components.code,{children:`409`}),`. See `,_jsx(_components.a,{href:`/services/egocentric#submit-a-batch`,children:`submission and replay examples`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`For authentication, limits, and HTTP errors, see the `,_jsx(_components.a,{href:`/services/egocentric`,children:`workflow`}),` and `,_jsx(_components.a,{href:`/services/egocentric-limits-and-errors`,children:`error guide`}),`.`]})]})}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":{"config":{},"pageMetadata":{"title":"Submit an egocentric batch","description":"Submit an egocentric batch with the Egocentric API.","openapi":"api-reference/openapi.json POST /v1/egocentric/batches","href":"/api-reference/egocentric/submit-an-egocentric-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Egocentric"],"summary":"Submit an egocentric batch","description":"Submit an egocentric batch with the Egocentric API.","operationId":"submit_batch","parameters":["adca402f-a78a-4ffc-8a85-f39be4e7eae6"],"requestBody":"ace875a6-e526-4c6b-a13f-32f28852f014","responses":{"202":"e8217337-92ba-48d5-a227-3b2f0edc0451","400":"5089e53e-f489-4862-bf21-f8c146ca86b5","401":"9c83829a-7241-48d0-9d54-c066813e0305","409":"14b71840-43f3-41cf-a46a-41ef74be2661","413":"742e8986-a190-416b-a839-e06d76a66a29","429":"2eb0adc8-9b77-4470-8e1d-cc3d3c9b70d5","500":"2171e964-ac3a-4d23-b2ea-a9bdcf382d37","503":"787789e9-9184-4b12-9538-21d060b642e6"},"security":["601bb738-8635-4cfc-9294-447e75445a8b"],"method":"post","type":"path","servers":["16d03011-ad5e-449c-a789-eb4f6a23bc43"],"path":"/v1/egocentric/batches","baseUrlOptions":["https://api.perceptron.inc"],"title":"Submit an egocentric batch","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"adca402f-a78a-4ffc-8a85-f39be4e7eae6":{"name":"Idempotency-Key","in":"header","description":"A single organization-scoped key of 1 to 255 visible ASCII characters; reuse only with the same request.","required":true,"schema":{"type":"string","maxLength":255,"minLength":1,"isRequired":true,"description":"A single organization-scoped key of 1 to 255 visible ASCII characters; reuse only with the same request.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Submit videos for annotation with shared options.","required":["inputs"],"properties":{"inputs":{"type":"array","items":{"type":"object","description":"One video source and its optional display filename.","required":["type","video_url"],"properties":{"type":{"type":"string","description":"Input source type, currently video_url.","enum":["video_url"],"isRequired":true,"uniqueKey":"inputs.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"video_url":{"type":"object","description":"URL of the video to annotate.","required":["url"],"properties":{"url":{"type":"string","description":"HTTP or HTTPS URL of the video to annotate.","maxLength":4096,"isRequired":true,"uniqueKey":"inputs.items.[INDEX].video_url.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"inputs.items.[INDEX].video_url","typeLabel":"object"},"filename":{"type":"string","description":"Optional filename: 1 to 255 characters, without path separators or control\ncharacters. The names `.` and `..` and an explicit null are rejected.","maxLength":255,"minLength":1,"uniqueKey":"inputs.items.[INDEX].filename","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"inputs.items.[INDEX]","typeLabel":"object"},"description":"Videos to annotate, in the order their jobs will be returned.","maxItems":1000,"minItems":1,"isRequired":true,"uniqueKey":"inputs","typeLabel":"object[]"},"hand_activity":{"type":"boolean","description":"Include hand activity annotations; defaults to true.","uniqueKey":"hand_activity","typeLabel":"boolean"},"hand_tracking":{"oneOf":[{"type":"boolean","title":"Enable or disable hand tracking","description":"Hand tracking selection; omitted or true enables the default 2d output, and false disables it.","uniqueKey":"hand_tracking.oneOf.0","typeLabel":"boolean"},{"type":"object","title":"Hand tracking settings","description":"Hand tracking selection; omitted or true enables the default 2d output, and false disables it.","required":["output"],"properties":{"output":{"type":"string","description":"Select 2d keypoints or the additional 3d mesh and joints.","enum":["2d","3d"],"isRequired":true,"uniqueKey":"hand_tracking.oneOf.1.output","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"hand_tracking.oneOf.1","typeLabel":"Hand tracking settings · object"}],"uniqueKey":"hand_tracking","typeLabel":"boolean | Hand tracking settings · object"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"inputs":[{"type":"video_url","video_url":{"url":"\u003cstring>"},"filename":"\u003cstring>"}],"hand_activity":true,"hand_tracking":true}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"e8217337-92ba-48d5-a227-3b2f0edc0451":{"description":"Batch accepted","headers":{"Location":{"schema":{"type":"string"},"description":"Relative URL of the accepted batch; unchanged on replay."}},"content":{"application/json":{"schema":{"type":"object","description":"The current batch and its job identifiers, in the original input order.","required":["jobs","object","id","job_count","options","counts","done","created_at","started_at","execution_finished_at","finished_at"],"properties":{"counts":{"type":"object","description":"Job counts by public state, including zero counts.","required":["queued","submitted","processing","completed","failed"],"properties":{"completed":{"type":"integer","format":"int32","description":"Jobs that finished successfully.","minimum":0,"isRequired":true,"uniqueKey":"counts.completed","typeLabel":"integer\u003cint32>"},"failed":{"type":"integer","format":"int32","description":"Jobs that finished without a result.","minimum":0,"isRequired":true,"uniqueKey":"counts.failed","typeLabel":"integer\u003cint32>"},"processing":{"type":"integer","format":"int32","description":"Jobs whose execution has started and that are not yet finished.","minimum":0,"isRequired":true,"uniqueKey":"counts.processing","typeLabel":"integer\u003cint32>"},"queued":{"type":"integer","format":"int32","description":"Jobs preparing inputs or waiting for capacity.","minimum":0,"isRequired":true,"uniqueKey":"counts.queued","typeLabel":"integer\u003cint32>"},"submitted":{"type":"integer","format":"int32","description":"Jobs accepted for execution and waiting to run.","minimum":0,"isRequired":true,"uniqueKey":"counts.submitted","typeLabel":"integer\u003cint32>"}},"isRequired":true,"uniqueKey":"counts","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","description":"UTC time the batch was accepted.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"done":{"type":"boolean","description":"True once every job has completed or failed.","isRequired":true,"uniqueKey":"done","typeLabel":"boolean"},"execution_finished_at":{"oneOf":[{"type":"string","format":"date-time","description":"Latest actual execution end once every job has a known end or is confirmed never to have run.\nNull if any end is unknown or no job ran.","isRequired":true,"uniqueKey":"execution_finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Latest actual execution end once every job has a known end or is confirmed never to have run.\nNull if any end is unknown or no job ran.","isRequired":true,"uniqueKey":"execution_finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"execution_finished_at","typeLabel":"string\u003cdate-time> | null"},"finished_at":{"oneOf":[{"type":"string","format":"date-time","description":"Time the last job finished; null until done is true.","isRequired":true,"uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Time the last job finished; null until done is true.","isRequired":true,"uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"},"id":{"type":"string","description":"Unique batch identifier.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"job_count":{"type":"integer","format":"int32","description":"Number of submitted inputs and jobs.","maximum":1000,"minimum":1,"isRequired":true,"uniqueKey":"job_count","typeLabel":"integer\u003cint32>"},"object":{"type":"string","description":"Object type, always egocentric.batch.","example":"egocentric.batch","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"options":{"type":"object","description":"Options applied to every job, with defaults filled in at acceptance.","required":["hand_tracking","hand_activity"],"properties":{"hand_activity":{"type":"boolean","description":"Whether hand activity annotations are included.","isRequired":true,"uniqueKey":"options.hand_activity","typeLabel":"boolean"},"hand_tracking":{"oneOf":[{"type":"boolean","title":"Hand tracking disabled","description":"Disabled, or enabled with the output format fixed when the batch was accepted.","enum":[false],"isRequired":true,"uniqueKey":"options.hand_tracking.oneOf.0","typeLabel":"enum\u003cboolean>"},{"type":"object","title":"Hand tracking settings","description":"Disabled, or enabled with the output format fixed when the batch was accepted.","required":["output"],"properties":{"output":{"type":"string","description":"Hand tracking format: 2d includes per-frame boxes and keypoints;\n3d also includes a mesh and 3D joints.","enum":["2d","3d"],"isRequired":true,"uniqueKey":"options.hand_tracking.oneOf.1.output","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"options.hand_tracking.oneOf.1","typeLabel":"Hand tracking settings · object"}],"isRequired":true,"uniqueKey":"options.hand_tracking","typeLabel":"enum\u003cboolean> | Hand tracking settings · object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"options","typeLabel":"object"},"started_at":{"oneOf":[{"type":"string","format":"date-time","description":"Earliest known actual execution start across its jobs; null if no start is known.","isRequired":true,"uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Earliest known actual execution start across its jobs; null if no start is known.","isRequired":true,"uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"jobs":{"type":"array","items":{"type":"object","description":"Identifier of a job accepted in a batch.","required":["id"],"properties":{"id":{"type":"string","description":"Unique job identifier.","isRequired":true,"uniqueKey":"jobs.items.[INDEX].id","typeLabel":"string"}},"uniqueKey":"jobs.items.[INDEX]","typeLabel":"object"},"description":"Accepted job identifiers in the same order as the submitted inputs.","isRequired":true,"uniqueKey":"jobs","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"counts":{"completed":1,"failed":1,"processing":1,"queued":1,"submitted":1},"created_at":"2023-11-07T05:31:56Z","done":true,"execution_finished_at":"2023-11-07T05:31:56Z","finished_at":"2023-11-07T05:31:56Z","id":"\u003cstring>","job_count":500,"object":"egocentric.batch","options":{"hand_activity":true,"hand_tracking":false},"started_at":"2023-11-07T05:31:56Z","jobs":[{"id":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"5089e53e-f489-4862-bf21-f8c146ca86b5":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9c83829a-7241-48d0-9d54-c066813e0305":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"14b71840-43f3-41cf-a46a-41ef74be2661":{"description":"Idempotency conflict","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"742e8986-a190-416b-a839-e06d76a66a29":{"description":"Request body exceeds 8 MiB","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2eb0adc8-9b77-4470-8e1d-cc3d3c9b70d5":{"description":"Capacity or credit limit","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying; omitted for insufficient credits."}},"content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2171e964-ac3a-4d23-b2ea-a9bdcf382d37":{"description":"Unexpected error","content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"787789e9-9184-4b12-9538-21d060b642e6":{"description":"Temporarily unavailable","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying; omitted for insufficient credits."}},"content":{"application/json":{"schema":{"type":"object","description":"Native Perceptron error response format.","required":["error"],"properties":{"error":{"type":"object","description":"Native Perceptron error detail.","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"error.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.type","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","code":"\u003cstring>","param":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"601bb738-8635-4cfc-9294-447e75445a8b":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Bearer token authentication using your Perceptron API key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"16d03011-ad5e-449c-a789-eb4f6a23bc43":{"url":"https://api.perceptron.inc"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer token authentication using your Perceptron API key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication using your Perceptron API key","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"perceptron","siteName":"Perceptron Docs","title":"Submit an egocentric batch - Perceptron Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T10:34:48.760Z","originalFileLocation":"api-reference/egocentric/submit-an-egocentric-batch.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=\"Submit an egocentric batch with the Egocentric API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Perceptron 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/perceptron/b-1oIqD5B-JgaDLb/_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/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/perceptron/b-1oIqD5B-JgaDLb/_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/perceptron/b-1oIqD5B-JgaDLb/_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/perceptron/b-1oIqD5B-JgaDLb/_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/perceptron/b-1oIqD5B-JgaDLb/_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/perceptron/b-1oIqD5B-JgaDLb/_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/perceptron/b-1oIqD5B-JgaDLb/_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/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit an egocentric batch - Perceptron Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submit an egocentric batch with the Egocentric API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Perceptron Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://perceptron.mintlify.app/_mintlify/api/og/v2?division=Egocentric\u0026amp;title=Submit+an+egocentric+batch\u0026amp;description=Submit+an+egocentric+batch+with+the+Egocentric+API.\u0026amp;theme=ceaeb19d1c5c0da2f2187829\u0026amp;signature=a9b7fb88199ae3d53cfb05e3b47314490b944fda2af90fb0f1a8704b7279d5a8\">\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=\"Submit an egocentric batch - Perceptron Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submit an egocentric batch with the Egocentric API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://perceptron.mintlify.app/_mintlify/api/og/v2?division=Egocentric\u0026amp;title=Submit+an+egocentric+batch\u0026amp;description=Submit+an+egocentric+batch+with+the+Egocentric+API.\u0026amp;theme=ceaeb19d1c5c0da2f2187829\u0026amp;signature=a9b7fb88199ae3d53cfb05e3b47314490b944fda2af90fb0f1a8704b7279d5a8\">\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/perceptron/b-1oIqD5B-JgaDLb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Perceptron Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B63FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/egocentric/submit-an-egocentric-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.perceptron.inc/#organization\",\"name\":\"Perceptron Docs\",\"url\":\"https://docs.perceptron.inc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/perceptron/CuyGah1e2BqRrsVm/logo/perceptron-full-logo-light.svg?fit=max\u0026auto=format\u0026n=CuyGah1e2BqRrsVm\u0026q=85\u0026s=f5d2ffd0aaf71daba362f13fc9f7decf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.perceptron.inc#website\",\"name\":\"Perceptron Docs\",\"url\":\"https://docs.perceptron.inc\",\"publisher\":{\"@id\":\"https://docs.perceptron.inc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch#webpage\",\"url\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch\",\"name\":\"Submit an egocentric batch\",\"description\":\"Submit an egocentric batch with the Egocentric API.\",\"dateModified\":\"2026-11-04T10:34:48.760Z\",\"isPartOf\":{\"@id\":\"https://docs.perceptron.inc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Services\",\"item\":\"https://docs.perceptron.inc/api-reference/detection/detect-objects\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Submit an egocentric batch\",\"item\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch#apireference\",\"headline\":\"Submit an egocentric batch\",\"name\":\"Submit an egocentric batch\",\"description\":\"Submit an egocentric batch with the Egocentric API.\",\"url\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.perceptron.inc/api-reference/egocentric/submit-an-egocentric-batch#webpage\"},\"dateModified\":\"2026-11-04T10:34:48.760Z\",\"publisher\":{\"@id\":\"https://docs.perceptron.inc/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.perceptron.inc#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Perceptron Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Perceptron Docs","nav":{"global":null,"tabs":[{"tab":"Overview","icon":"house","pages":[{"title":"Overview","href":""}]},{"tab":"Models","icon":"microchip","dropdowns":[{"dropdown":"Perceptron Mk1.5","icon":"microchip","description":"Latest","groups":[{"group":"Get started","pages":[{"title":"Models overview","sidebarTitle":"All models","href":"/models"},{"title":"Quickstart","icon":"rocket","href":"/perceptron-mk1.5/index"},{"title":"Perceptron Mk1.5","sidebarTitle":"Model spec","href":"/perceptron-mk1.5/models/perceptron-mk1.5"},{"title":"Release notes","href":"/perceptron-mk1.5/changelog"}]},{"group":"Capabilities","pages":[{"group":"Image","pages":[{"title":"Image understanding","href":"/perceptron-mk1.5/capabilities/image-understanding"},{"title":"Image Q\u0026A","sidebarTitle":"Image Q\u0026A","href":"/perceptron-mk1.5/capabilities/image-qa"},{"title":"Image captioning","href":"/perceptron-mk1.5/capabilities/image-captioning"},{"title":"Object detection","href":"/perceptron-mk1.5/capabilities/object-detection"},{"title":"OCR","href":"/perceptron-mk1.5/capabilities/ocr"},{"title":"In-context learning (image)","sidebarTitle":"ICL (image)","href":"/perceptron-mk1.5/capabilities/in-context-learning-image"}]},{"group":"Video","pages":[{"title":"Video understanding","href":"/perceptron-mk1.5/capabilities/video-understanding"},{"title":"Video Q\u0026A","sidebarTitle":"Video Q\u0026A","href":"/perceptron-mk1.5/capabilities/video-qa"},{"title":"Video clipping","sidebarTitle":"Video clipping","href":"/perceptron-mk1.5/capabilities/video-clipping"},{"title":"In-context learning (video)","sidebarTitle":"ICL (video)","href":"/perceptron-mk1.5/capabilities/in-context-learning-video"},{"title":"Video tracking","href":"/perceptron-mk1.5/capabilities/video-tracking"}]},{"group":"Audio","pages":[{"title":"Audio understanding","href":"/perceptron-mk1.5/capabilities/audio"},{"title":"Audio Q\u0026A","sidebarTitle":"Audio Q\u0026A","href":"/perceptron-mk1.5/capabilities/audio-qa"},{"title":"Audio transcription","href":"/perceptron-mk1.5/capabilities/audio-transcription"},{"title":"Audio clipping","href":"/perceptron-mk1.5/capabilities/audio-clipping"}]},{"title":"Tools","sidebarTitle":"Tools","href":"/perceptron-mk1.5/capabilities/tool-calling"},{"title":"Reasoning","href":"/perceptron-mk1.5/capabilities/thinking"},{"title":"Structured outputs","href":"/perceptron-mk1.5/capabilities/structured-outputs"}]},{"group":"Developer guides","pages":[{"group":"Python SDK","pages":[{"title":"Get started with Python","sidebarTitle":"Get started","href":"/perceptron-mk1.5/guides/python/getting-started"},{"title":"Authentication","href":"/perceptron-mk1.5/guides/python/auth"},{"title":"Request basics","href":"/perceptron-mk1.5/guides/python/request-basics"},{"title":"Rendering annotations","href":"/perceptron-mk1.5/guides/rendering-annotations"},{"title":"Coordinate system","href":"/perceptron-mk1.5/concepts/coordinates"},{"title":"Python FAQs","sidebarTitle":"FAQs","href":"/perceptron-mk1.5/guides/python/faqs"}]},{"title":"Annotation format","href":"/perceptron-mk1.5/concepts/annotations"},{"title":"Multiple assets","href":"/perceptron-mk1.5/guides/multiple-assets"},{"title":"Function calling","href":"/perceptron-mk1.5/guides/tool-calling"},{"title":"Files","href":"/perceptron-mk1.5/guides/files"},{"title":"Multilook","href":"/perceptron-mk1.5/guides/multilook"},{"title":"MCP","href":"/perceptron-mk1.5/guides/mcp"},{"title":"Error messages","href":"/perceptron-mk1.5/guides/error-messages"}]},{"group":"Scaling \u0026 deployment","pages":[{"title":"Batch processing","href":"/perceptron-mk1.5/guides/batch"},{"title":"Scaling","href":"/perceptron-mk1.5/guides/scaling"},{"title":"Tokenization","href":"/perceptron-mk1.5/guides/tokenization"}]},{"group":"Best practices","pages":[{"title":"Prompting reference","href":"/perceptron-mk1.5/best-practices/prompting-reference"},{"title":"Security","href":"/perceptron-mk1.5/best-practices/security"},{"title":"Building a tool agent","href":"/perceptron-mk1.5/guides/tool-agents"},{"title":"High-fidelity object tracking","href":"/perceptron-mk1.5/guides/high-fidelity-object-tracking"}]}]},{"dropdown":"Perceptron Mk1","icon":"microchip","groups":[{"group":"Get started","pages":[{"title":"Quickstart","icon":"rocket","sidebarTitle":"Quickstart","href":"/perceptron-mk1/index"},{"title":"Perceptron Mk1","sidebarTitle":"Model spec","href":"/perceptron-mk1/models/perceptron-mk1"},{"title":"Release notes","href":"/perceptron-mk1/changelog"}]},{"group":"Capabilities","pages":[{"group":"Image","pages":[{"title":"Image Q\u0026A","sidebarTitle":"Image Q\u0026A","href":"/perceptron-mk1/capabilities/image-qa"},{"title":"Image captioning","sidebarTitle":"Image captioning","href":"/perceptron-mk1/capabilities/image-captioning"},{"title":"Object detection","href":"/perceptron-mk1/capabilities/object-detection"},{"title":"OCR","href":"/perceptron-mk1/capabilities/ocr"},{"title":"In-context learning (image)","sidebarTitle":"ICL (image)","href":"/perceptron-mk1/capabilities/in-context-learning-image"}]},{"group":"Video","pages":[{"title":"Video Q\u0026A","sidebarTitle":"Video Q\u0026A","href":"/perceptron-mk1/capabilities/video-qa"},{"title":"Video clipping","sidebarTitle":"Video clipping","href":"/perceptron-mk1/capabilities/video-clipping"},{"title":"In-context learning (video)","sidebarTitle":"ICL (video)","href":"/perceptron-mk1/capabilities/in-context-learning-video"}]},{"title":"Thinking","href":"/perceptron-mk1/capabilities/thinking"},{"title":"Structured outputs","href":"/perceptron-mk1/capabilities/structured-outputs"}]},{"group":"Developer guides","pages":[{"group":"Python SDK","pages":[{"title":"Get started","href":"/perceptron-mk1/guides/python-sdk/getting-started"},{"title":"Authentication","href":"/perceptron-mk1/guides/python-sdk/auth"},{"title":"Pointing basics","href":"/perceptron-mk1/guides/python-sdk/pointing-basics"},{"title":"Perceive basics","href":"/perceptron-mk1/guides/python-sdk/perceive-basics"},{"title":"Coordinate system","href":"/perceptron-mk1/concepts/coordinates"},{"title":"Python SDK FAQs","sidebarTitle":"FAQs","href":"/perceptron-mk1/guides/python-sdk/faqs"}]},{"title":"Files","href":"/perceptron-mk1/guides/files"},{"title":"Multilook","href":"/perceptron-mk1/guides/multilook"},{"title":"MCP","href":"/perceptron-mk1/guides/mcp"},{"title":"Error messages","href":"/perceptron-mk1/guides/error-messages"}]},{"group":"Scaling \u0026 deployment","pages":[{"title":"Batch processing","href":"/perceptron-mk1/guides/batch"},{"title":"Scaling","href":"/perceptron-mk1/guides/scaling"},{"title":"Tokenization","href":"/perceptron-mk1/guides/tokenization"}]},{"group":"Best practices","pages":[{"title":"Prompting reference","href":"/perceptron-mk1/best-practices/prompting-reference"},{"title":"Security","href":"/perceptron-mk1/best-practices/security"}]}]}]},{"tab":"Services","icon":"server","pages":[{"title":"Services","href":"/services"}]},{"tab":"API reference","icon":"code","dropdowns":[{"dropdown":"Perceptron Mk1.5","icon":"microchip","description":"Latest","groups":[{"group":"API reference","pages":[{"title":"API reference","sidebarTitle":"Overview","href":"/api-reference"}]},{"group":"Chat completions","pages":[{"title":"Create chat completion","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/chat/completions","href":"/api-reference/chat-completions/create-chat-completion"},{"title":"Create multilook chat completions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/chat/completions/multilook","href":"/api-reference/chat-completions/create-multilook-chat-completions"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files","href":"/api-reference/files/list-files"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/files","href":"/api-reference/files/upload-a-file"},{"title":"Retrieve a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files/{file_id}","href":"/api-reference/files/retrieve-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/files/{file_id}","href":"/api-reference/files/delete-a-file"},{"title":"Download a file's contents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/files/{file_id}/content","href":"/api-reference/files/download-a-files-contents"}]},{"group":"Models","pages":[{"title":"List available models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/models","href":"/api-reference/models/list-available-models"},{"title":"Retrieve a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/models/{model_id}","href":"/api-reference/models/retrieve-a-model"}]},{"group":"Services","pages":[{"group":"Detect","pages":[{"title":"Detect objects","description":"Return grounded object detections for a single image from text categories, annotated exemplars, or exhaustive detection.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/detect","href":"/api-reference/detection/detect-objects"}]},{"group":"Egocentric","pages":[{"title":"Submit an egocentric batch","openapi":"api-reference/openapi.json POST /v1/egocentric/batches","href":"/api-reference/egocentric/submit-an-egocentric-batch"},{"title":"List egocentric batches","description":"List egocentric batches with the Egocentric API.","openapi":"api-reference/openapi.json GET /v1/egocentric/batches","href":"/api-reference/egocentric/list-egocentric-batches"},{"title":"Retrieve an egocentric batch","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}","href":"/api-reference/egocentric/retrieve-an-egocentric-batch"},{"title":"List jobs in an egocentric batch","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}/jobs","href":"/api-reference/egocentric/list-jobs-in-an-egocentric-batch"},{"title":"List egocentric jobs","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs","href":"/api-reference/egocentric/list-egocentric-jobs"},{"title":"Retrieve an egocentric job","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}","href":"/api-reference/egocentric/retrieve-an-egocentric-job"},{"title":"Download an egocentric result","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}/result","href":"/api-reference/egocentric/download-an-egocentric-result"}]}]}]},{"dropdown":"Perceptron Mk1","icon":"microchip","groups":[{"group":"API reference","pages":[{"title":"Perceptron Mk1 API reference","sidebarTitle":"Overview","href":"/perceptron-mk1/api-reference"}]},{"group":"Chat completions","pages":[{"title":"Create chat completion (Mk1)","api":"POST https://api.perceptron.inc/v1/chat/completions","playground":"simple","href":"/perceptron-mk1/api-reference/endpoint/chat-completions"},{"title":"Create multilook chat completions (Mk1)","api":"POST https://api.perceptron.inc/v1/chat/completions/multilook","playground":"simple","href":"/perceptron-mk1/api-reference/endpoint/multilook-chat-completions"}]},{"group":"Files","pages":[{"title":"List files","openapi":"api-reference/openapi.json GET /v1/files","href":"/perceptron-mk1/api-reference/files/list-files"},{"title":"Upload a file","openapi":"api-reference/openapi.json POST /v1/files","href":"/perceptron-mk1/api-reference/files/upload-a-file"},{"title":"Retrieve a file","openapi":"api-reference/openapi.json GET /v1/files/{file_id}","href":"/perceptron-mk1/api-reference/files/retrieve-a-file"},{"title":"Delete a file","openapi":"api-reference/openapi.json DELETE /v1/files/{file_id}","href":"/perceptron-mk1/api-reference/files/delete-a-file"},{"title":"Download a file's contents","openapi":"api-reference/openapi.json GET /v1/files/{file_id}/content","href":"/perceptron-mk1/api-reference/files/download-a-files-contents"}]},{"group":"Models","pages":[{"title":"List available models","openapi":"api-reference/openapi.json GET /v1/models","href":"/perceptron-mk1/api-reference/models/list-available-models"},{"title":"Retrieve a model","openapi":"api-reference/openapi.json GET /v1/models/{model_id}","href":"/perceptron-mk1/api-reference/models/retrieve-a-model"}]},{"group":"Services","pages":[{"group":"Detect","pages":[{"title":"Detect objects","openapi":"api-reference/openapi.json POST /v1/detect","href":"/perceptron-mk1/api-reference/services/detect-objects"}]},{"group":"Egocentric","pages":[{"title":"Submit an egocentric batch","openapi":"api-reference/openapi.json POST /v1/egocentric/batches","href":"/perceptron-mk1/api-reference/services/egocentric/submit-an-egocentric-batch"},{"title":"List egocentric batches","openapi":"api-reference/openapi.json GET /v1/egocentric/batches","href":"/perceptron-mk1/api-reference/services/egocentric/list-egocentric-batches"},{"title":"Retrieve an egocentric batch","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}","href":"/perceptron-mk1/api-reference/services/egocentric/retrieve-an-egocentric-batch"},{"title":"List jobs in an egocentric batch","openapi":"api-reference/openapi.json GET /v1/egocentric/batches/{batch_id}/jobs","href":"/perceptron-mk1/api-reference/services/egocentric/list-jobs-in-an-egocentric-batch"},{"title":"List egocentric jobs","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs","href":"/perceptron-mk1/api-reference/services/egocentric/list-egocentric-jobs"},{"title":"Retrieve an egocentric job","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}","href":"/perceptron-mk1/api-reference/services/egocentric/retrieve-an-egocentric-job"},{"title":"Download an egocentric result","openapi":"api-reference/openapi.json GET /v1/egocentric/jobs/{job_id}/result","href":"/perceptron-mk1/api-reference/services/egocentric/download-an-egocentric-result"}]}]}]}]}]},"basePath":"","title":"Submit an egocentric batch - Perceptron Docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}