{ "video": { "id": 12345, "prompt": "A cat walking on the beach at sunset", "url": "", "model": "Veo 3.1 Fast", "status": "processing", "created_at": "2025-01-15T10:30:00.000Z", "request": { "duration": "4s", "aspectRatio": "16:9", "isTextToVideo": true, "isImageToVideo": false } }}
Video Generation
Get Video
Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the status is completed and the url field contains the video URL.
GET
/
api
/
get-video
Get Video
curl --request GET \ --url https://easy-peasy.ai/api/get-video \ --header 'x-api-key: <api-key>'
{ "video": { "id": 12345, "prompt": "A cat walking on the beach at sunset", "url": "", "model": "Veo 3.1 Fast", "status": "processing", "created_at": "2025-01-15T10:30:00.000Z", "request": { "duration": "4s", "aspectRatio": "16:9", "isTextToVideo": true, "isImageToVideo": false } }}
Pass the id returned by Generate Video or Generate Talking Video as the video_id query parameter. Use the same account’s API key.Read video.status and video.url. The endpoint exposes processing and completed; it does not expose a failed status. HTTP 404 means the job is missing, deleted, or unavailable to this account, including some failed jobs.See the bounded polling example. A client timeout does not cancel the job.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Easy-Peasy.AI Docs","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/easy-peasyai/kLHRxZMJyyWSlR-b/logo/marky.png?fit=max\u0026auto=format\u0026n=kLHRxZMJyyWSlR-b\u0026q=85\u0026s=59994034f7c7508e0f18c4f7a40ea9b5","dark":"https://mintcdn.com/easy-peasyai/kLHRxZMJyyWSlR-b/logo/marky.png?fit=max\u0026auto=format\u0026n=kLHRxZMJyyWSlR-b\u0026q=85\u0026s=59994034f7c7508e0f18c4f7a40ea9b5","href":"https://easy-peasy.ai"},"favicon":"https://mintcdn.com/easy-peasyai/BzYZncJWg82D12rl/favicon.png?fit=max\u0026auto=format\u0026n=BzYZncJWg82D12rl\u0026q=85\u0026s=56baca1aff94e50c5f7a09f8c06fe351","appearance":{"default":"light"},"navbar":{"links":[{"href":"https://easy-peasy.ai/support","label":"Help \u0026 Support"}],"primary":{"type":"button","label":"Open dashboard","href":"https://easy-peasy.ai/dashboard"}},"footer":{"socials":{"x":"https://x.com/easy_peasy_ai","website":"https://easy-peasy.ai"}},"search":{"prompt":"Search the docs"},"styling":{"eyebrows":"section","latex":false},"contextual":{"options":["copy","view",{"title":"Open in Marky Agent","description":"Ask Marky about this page","icon":"/favicon.png","href":{"base":"https://easy-peasy.ai/chat","query":[{"key":"prompt","value":"Read from https://easy-peasy.ai/docs$path.md so I can ask questions about it."}]}},"chatgpt","claude","cursor"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"easy-peasyai","hasAudioNarration":false,"actualSubdomain":"easy-peasyai","customDomains":["easy-peasy.ai"],"gitSource":{"type":"github","owner":"easy-peasy-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae4348787a6b80b471b6660","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Guides","count":115},{"language":"default","tag":"Agents","count":29},{"language":"default","tag":"API Reference","count":19},{"language":"default","tag":"AI Employees","count":16},{"language":"default","tag":"Marky Agent","count":14},{"language":"default","tag":"AI Videos","count":14},{"language":"default","tag":"Channels","count":13},{"language":"default","tag":"AI Images","count":11},{"language":"default","tag":"Audio","count":11},{"language":"default","tag":"Account \u0026 billing","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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":"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/get-video","slug":"/api-reference/endpoint/get-video","pageMetadata":{"title":"Get Video","openapi":"GET /api/get-video","description":"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the `status` is `completed` and the `url` field contains the video URL.","href":"/api-reference/endpoint/get-video"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the \", _jsx(_components.code, {\n children: \"status\"\n }), \" is \", _jsx(_components.code, {\n children: \"completed\"\n }), \" and the \", _jsx(_components.code, {\n children: \"url\"\n }), \" field contains the video URL.\"]\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:[`Pass the `,_jsx(_components.code,{children:`id`}),` returned by Generate Video or Generate Talking Video as the `,_jsx(_components.code,{children:`video_id`}),` query parameter. Use the same account’s API key.`]}),`\n`,_jsxs(_components.p,{children:[`Read `,_jsx(_components.code,{children:`video.status`}),` and `,_jsx(_components.code,{children:`video.url`}),`. The endpoint exposes `,_jsx(_components.code,{children:`processing`}),` and `,_jsx(_components.code,{children:`completed`}),`; it does not expose a `,_jsx(_components.code,{children:`failed`}),` status. HTTP 404 means the job is missing, deleted, or unavailable to this account, including some failed jobs.`]}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/api-reference/endpoint/generate-video#poll-for-the-result`,children:`bounded polling example`}),`. A client timeout does not cancel the job.`]})]})}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":"Get Video","openapi":"GET /api/get-video","description":"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the `status` is `completed` and the `url` field contains the video URL.","href":"/api-reference/endpoint/get-video"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get Video","operationId":"getVideo","description":"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the `status` is `completed` and the `url` field contains the video URL.","parameters":["aedd330d-74eb-49c5-8771-9abc37ab1d6b"],"responses":{"200":"706f7997-b04a-42d4-ad91-99e76f0acba7","400":"58688518-5c0b-4629-b89c-c086be7dd797","401":"cf827448-a908-4ce6-90ba-927f78beec85","404":"4321013f-d826-4009-8b7c-a4169c4f8a8a","405":"cd2c608e-ce67-4176-a5ea-593b23b773f9"},"method":"get","type":"path","servers":["341c5f3e-c44b-4765-bc85-0c4cf1b9119d"],"security":["4aeb4ddf-7ca6-4487-bfab-fb3b0e8515da"],"path":"/api/get-video","baseUrlOptions":["https://easy-peasy.ai"],"title":"Get Video","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"aedd330d-74eb-49c5-8771-9abc37ab1d6b":{"name":"video_id","in":"query","required":true,"schema":{"type":"string","isRequired":true,"description":"The video ID returned from the Generate Video endpoint","uniqueKey":"","typeLabel":"string"},"description":"The video ID returned from the Generate Video endpoint"}},"responses":{"706f7997-b04a-42d4-ad91-99e76f0acba7":{"description":"Video data","content":{"application/json":{"schema":{"type":"object","properties":{"video":{"type":"object","properties":{"id":{"type":"integer","description":"Video ID","uniqueKey":"video.id","typeLabel":"integer"},"prompt":{"type":"string","description":"The prompt used for generation","uniqueKey":"video.prompt","typeLabel":"string"},"url":{"type":"string","description":"Video URL. Empty string while processing, populated when complete.","uniqueKey":"video.url","typeLabel":"string"},"model":{"type":"string","description":"The model used for generation","uniqueKey":"video.model","typeLabel":"string"},"status":{"type":"string","enum":["processing","completed"],"description":"Current status. `processing` means the video is still being generated. `completed` means the video URL is ready.","uniqueKey":"video.status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","uniqueKey":"video.created_at","typeLabel":"string\u003cdate-time>"},"request":{"type":"object","description":"The original request parameters","properties":{"duration":{"type":"string","uniqueKey":"video.request.duration","typeLabel":"string"},"aspectRatio":{"type":"string","uniqueKey":"video.request.aspectRatio","typeLabel":"string"},"isTextToVideo":{"type":"boolean","uniqueKey":"video.request.isTextToVideo","typeLabel":"boolean"},"isImageToVideo":{"type":"boolean","uniqueKey":"video.request.isImageToVideo","typeLabel":"boolean"}},"uniqueKey":"video.request","typeLabel":"object"}},"uniqueKey":"video","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"processing":{"title":"processing","value":{"video":{"id":12345,"prompt":"A cat walking on the beach at sunset","url":"","model":"Veo 3.1 Fast","status":"processing","created_at":"2025-01-15T10:30:00.000Z","request":{"duration":"4s","aspectRatio":"16:9","isTextToVideo":true,"isImageToVideo":false}}}},"completed":{"title":"completed","value":{"video":{"id":12345,"prompt":"A cat walking on the beach at sunset","url":"https://media.easy-peasy.ai/videos/abc123.mp4","model":"Veo 3.1 Fast","status":"completed","created_at":"2025-01-15T10:30:00.000Z","request":{"duration":"4s","aspectRatio":"16:9","isTextToVideo":true,"isImageToVideo":false}}}}},"exampleType":"examples"}},"exampleType":"examples"},"58688518-5c0b-4629-b89c-c086be7dd797":{"description":"Missing video_id.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"oneOf":[{"type":"string","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"object","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","properties":{"message":{"type":"string","uniqueKey":"error.oneOf.1.message","typeLabel":"string"},"status":{"type":"integer","uniqueKey":"error.oneOf.1.status","typeLabel":"integer"}},"uniqueKey":"error.oneOf.1","typeLabel":"object"}],"uniqueKey":"error","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid API key"}}},"exampleType":"generated"}},"exampleType":"generated"},"cf827448-a908-4ce6-90ba-927f78beec85":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"oneOf":[{"type":"string","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"object","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","properties":{"message":{"type":"string","uniqueKey":"error.oneOf.1.message","typeLabel":"string"},"status":{"type":"integer","uniqueKey":"error.oneOf.1.status","typeLabel":"integer"}},"uniqueKey":"error.oneOf.1","typeLabel":"object"}],"uniqueKey":"error","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Invalid API key"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"4321013f-d826-4009-8b7c-a4169c4f8a8a":{"description":"Video missing, deleted, or not accessible to this account. Some failed jobs are deleted and return 404.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"oneOf":[{"type":"string","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"object","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","properties":{"message":{"type":"string","uniqueKey":"error.oneOf.1.message","typeLabel":"string"},"status":{"type":"integer","uniqueKey":"error.oneOf.1.status","typeLabel":"integer"}},"uniqueKey":"error.oneOf.1","typeLabel":"object"}],"uniqueKey":"error","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Video not found"},"examples":{"Example":{"title":"Example","value":{"error":"Video not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"cd2c608e-ce67-4176-a5ea-593b23b773f9":{"description":"Method not allowed. Use GET.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"oneOf":[{"type":"string","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"object","description":"Error text, or an object with message and optional status for some provider integrations.","example":"Invalid API key","properties":{"message":{"type":"string","uniqueKey":"error.oneOf.1.message","typeLabel":"string"},"status":{"type":"integer","uniqueKey":"error.oneOf.1.status","typeLabel":"integer"}},"uniqueKey":"error.oneOf.1","typeLabel":"object"}],"uniqueKey":"error","typeLabel":"string | object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid API key"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4aeb4ddf-7ca6-4487-bfab-fb3b0e8515da":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication. Get yours at https://easy-peasy.ai/settings/api","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"341c5f3e-c44b-4765-bc85-0c4cf1b9119d":{"url":"https://easy-peasy.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication. Get yours at https://easy-peasy.ai/settings/api","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"API key for authentication. Get yours at https://easy-peasy.ai/settings/api","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"easy-peasyai","siteName":"Easy-Peasy.AI Docs","title":"Get Video - Easy-Peasy.AI Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-12T13:06:34.600Z","originalFileLocation":"api-reference/endpoint/get-video.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=\"light\"}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=\"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the status is completed and the url field contains the video URL.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Easy-Peasy.AI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Video - Easy-Peasy.AI Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the status is completed and the url field contains the video URL.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Easy-Peasy.AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://easy-peasyai.mintlify.site/docs/_mintlify/api/og/v2?division=Video+Generation\u0026amp;title=Get+Video\u0026amp;description=Retrieve+the+status+and+result+of+a+video+generation+request.+Since+video+generation+is+asynchronous+%28typically+1%E2%80%935+minutes%29%2C+poll+this+endpoint+every+15%E2%80%9330+sec\u0026amp;theme=e4192a553308564721da91ed\u0026amp;signature=c75e4160a41c2c57bbfa8e31842978ac65883e6c2c70bef38f39d2f9f13222bb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Video - Easy-Peasy.AI Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the status is completed and the url field contains the video URL.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://easy-peasyai.mintlify.site/docs/_mintlify/api/og/v2?division=Video+Generation\u0026amp;title=Get+Video\u0026amp;description=Retrieve+the+status+and+result+of+a+video+generation+request.+Since+video+generation+is+asynchronous+%28typically+1%E2%80%935+minutes%29%2C+poll+this+endpoint+every+15%E2%80%9330+sec\u0026amp;theme=e4192a553308564721da91ed\u0026amp;signature=c75e4160a41c2c57bbfa8e31842978ac65883e6c2c70bef38f39d2f9f13222bb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/easy-peasyai/Am3MO_FpKKCWWVV0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Easy-Peasy.AI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/endpoint/get-video.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://easy-peasy.ai/#organization\",\"name\":\"Easy-Peasy.AI Docs\",\"url\":\"https://easy-peasy.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/easy-peasyai/kLHRxZMJyyWSlR-b/logo/marky.png?fit=max\u0026auto=format\u0026n=kLHRxZMJyyWSlR-b\u0026q=85\u0026s=59994034f7c7508e0f18c4f7a40ea9b5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://easy-peasy.ai/docs#website\",\"name\":\"Easy-Peasy.AI Docs\",\"url\":\"https://easy-peasy.ai/docs\",\"publisher\":{\"@id\":\"https://easy-peasy.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video#webpage\",\"url\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video\",\"name\":\"Get Video\",\"description\":\"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the status is completed and the url field contains the video URL.\",\"dateModified\":\"2026-09-12T13:06:34.600Z\",\"isPartOf\":{\"@id\":\"https://easy-peasy.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Video Generation\",\"item\":\"https://easy-peasy.ai/docs/api-reference/video-models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Video\",\"item\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video#apireference\",\"headline\":\"Get Video\",\"name\":\"Get Video\",\"description\":\"Retrieve the status and result of a video generation request. Since video generation is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the status is completed and the url field contains the video URL.\",\"url\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video\",\"mainEntityOfPage\":{\"@id\":\"https://easy-peasy.ai/docs/api-reference/endpoint/get-video#webpage\"},\"dateModified\":\"2026-09-12T13:06:34.600Z\",\"publisher\":{\"@id\":\"https://easy-peasy.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://easy-peasy.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Easy-Peasy.AI Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Easy-Peasy.AI Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/endpoint/get-video.md","siteName":"Easy-Peasy.AI Docs","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":""}]},{"tab":"Developers","icon":"code","pages":[{"title":"Developers","href":"/developers/overview"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Text Generation","pages":[{"title":"List Presets","openapi":"GET /api/presets","href":"/api-reference/endpoint/list-presets"},{"title":"Get Preset Details","openapi":"GET /api/presets/{slug}","href":"/api-reference/endpoint/get-preset"},{"title":"Generate Text","openapi":"POST /api/generate","href":"/api-reference/endpoint/generate"}]},{"group":"Image Generation","pages":[{"title":"Generate Image","openapi":"POST /api/generate-image","href":"/api-reference/endpoint/generate-image"},{"title":"Get Image","openapi":"GET /api/get-image","href":"/api-reference/endpoint/get-image"}]},{"group":"Video Generation","pages":[{"title":"Video models","href":"/api-reference/video-models"},{"title":"Generate Video","openapi":"POST /api/generate-video","href":"/api-reference/endpoint/generate-video"},{"title":"Generate Talking Video","openapi":"POST /api/generate-talking-video","description":"Generate a talking video by animating a face image or video with speech. Provide either text + voice to generate audio, or supply your own audio file.\n\n**Input combinations:**\n- **Image + text + voice** — Generates speech from text using the specified voice, then animates the face in the image\n- **Image + audio** — Uses the provided audio to animate the face in the image\n- **Video + text + voice** — Generates speech from text, then lip-syncs the video\n- **Video + audio** — Lip-syncs the video with the provided audio\n\n**Models:**\n- `premium` — High-quality avatar generation (VEED Fabric). Supports 480p and 720p.\n- `standard` — Faster generation (WaveSpeed InfiniteTalk). Supports 480p and 720p.\n\nVideo generation is asynchronous. Use the [Get Video](/api-reference/endpoint/get-video) endpoint to poll for results.\n\n**Note:** Requires a paid plan. Image must be at least 512x512 pixels. Audio/video max 5 minutes.","href":"/api-reference/endpoint/generate-talking-video"},{"title":"Get Video","openapi":"GET /api/get-video","href":"/api-reference/endpoint/get-video"}]},{"group":"Transcription","pages":[{"title":"Create Transcription","openapi":"POST /api/transcriptions","description":"Programmatically create [AI Transcriptions](https://easy-peasy.ai/audios) from audio files.","href":"/api-reference/endpoint/create-transcription"},{"title":"Get Transcription Result","openapi":"POST /api/audios","href":"/api-reference/endpoint/get-transcription"},{"title":"Generate Audio Content","openapi":"POST /api/generate-audio-content","href":"/api-reference/endpoint/generate-audio-content"}]},{"group":"Text-to-Speech","pages":[{"title":"Get TTS Configuration","openapi":"GET /api/get-text-to-speech-config","href":"/api-reference/endpoint/get-tts-config"},{"title":"Get TTS Voices","openapi":"GET /api/get-text-to-speech-voices","href":"/api-reference/endpoint/get-tts-voices"},{"title":"Generate Text-to-Speech","openapi":"POST /api/generate-text-to-speech","href":"/api-reference/endpoint/generate-tts"}]},{"group":"Sound Effects","pages":[{"title":"Generate Sound Effect","openapi":"POST /api/generate-sound","href":"/api-reference/endpoint/generate-sound"}]},{"group":"Chat Completions","pages":[{"title":"Chat Completions (OpenAI-compatible)","openapi":"POST /api/chat/completions","href":"/api-reference/endpoint/chat-completions"}]},{"group":"Agents","pages":[{"title":"Chat with an agent","openapi":"POST /bot/{public_url}/api","href":"/api-reference/endpoint/chat-with-bot"}]}]}]},"basePath":"","title":"Get Video - Easy-Peasy.AI Docs","buildId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","deploymentId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CASS2Vpq.js","utils-4k9fyWRu.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-UU-UueZb.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BgJ0LOYq.js","snippetPresets-CMgzlMR-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BzEJegkK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CZuQIZdk.js","shallow-Bw5arfMA.js","getApiPlaygroundDisplay-Ds834aVN.js","CodeSnippet-CKzmjw9L.js","CodeSnippets-BRpgomdp.js","Page-DvEUoD2H.js","getPastedJson-B0N-Tn76.js","icon-DASMs9nC.js","MethodPill-BA6DBLqx.js","DuplicateIcon-BMT5qfbJ.js","createIcon-CNfwVWPx.js","DynamicMarkdown-JYyBNlrJ.js","SectionHeading-BbZnmz8a.js","axios-vUo_bRtp.js","Markdown-LUU0YLpA.js","clsx-Di4ek5Ae.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-VEVWQCR4.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CPszyu99.js"]}