A case-sensitive key for one intended submission: 1–255 ASCII letters, digits, periods, underscores, colons or hyphens. Reuse it for identical retries; use a fresh key for a new run.
What to replace, in order: each item names an image or an avatar. Leave it out for a style transfer or an edit described only in additionalInstructions.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Melius docs","colors":{"primary":"#000000","light":"#ffffff","dark":"#000000"},"logo":{"light":"https://mintcdn.com/melius/Iumd0dzsPc4PNcYZ/logo/melius-logo.svg?fit=max\u0026auto=format\u0026n=Iumd0dzsPc4PNcYZ\u0026q=85\u0026s=cff8b577f5dd7d6a49ade2a06ce020d8","dark":"https://mintcdn.com/melius/Iumd0dzsPc4PNcYZ/logo/melius-logo.svg?fit=max\u0026auto=format\u0026n=Iumd0dzsPc4PNcYZ\u0026q=85\u0026s=cff8b577f5dd7d6a49ade2a06ce020d8","href":"https://melius.com"},"favicon":"https://mintcdn.com/melius/jEBWVWvaAj_onetX/logo/icon.png?fit=max\u0026auto=format\u0026n=jEBWVWvaAj_onetX\u0026q=85\u0026s=2947ac9b5359fb636f1fbae223e5b93e","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","typescript","php","go","ruby"]}},"navbar":{"links":[{"href":"mailto:support@melius.com","label":"Support"},{"href":"https://melius.com/privacy","label":"Privacy"}],"primary":{"type":"button","label":"Go to Melius","href":"https://melius.com"}},"footer":{"socials":{"x":"https://x.com/trymelius","linkedin":"https://www.linkedin.com/company/meliusai"},"links":[{"header":"Contact","items":[{"label":"Support","href":"mailto:support@melius.com"},{"label":"Privacy","href":"mailto:privacy@melius.com"},{"label":"Security","href":"mailto:support@melius.com"}]},{"header":"Legal","items":[{"label":"Privacy policy","href":"https://melius.com/privacy"},{"label":"Terms of service","href":"https://melius.com/terms"}]}]},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"melius","hasAudioNarration":false,"actualSubdomain":"melius","customDomains":["docs.melius.com"],"gitSource":{"type":"github","owner":"melius-ai","repo":"monorepo","deployBranch":"main","contentDirectory":"docs/public","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af4c917e83b45570d15ac42","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API/CLI","count":84},{"language":"default","tag":"Getting started","count":30},{"language":"default","tag":"Help Center","count":17},{"language":"default","tag":"Runs","count":11},{"language":"default","tag":"Team skills","count":10},{"language":"default","tag":"Nodes","count":9},{"language":"default","tag":"Recipes","count":7},{"language":"default","tag":"Models","count":7},{"language":"default","tag":"Canvases","count":7},{"language":"default","tag":"CLI","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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/ditto/create-a-ditto-video","slug":"/api-reference/ditto/create-a-ditto-video","pageMetadata":{"title":"Create a Ditto video","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/ditto","href":"/api-reference/ditto/create-a-ditto-video","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a Ditto video","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/ditto","href":"/api-reference/ditto/create-a-ditto-video","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"ditto.create","tags":["ditto"],"summary":"Create a Ditto video","parameters":["c19d044a-f4ec-4983-a509-849b62a47302"],"requestBody":"49c18981-c432-4ab0-a205-1cd780e011f3","responses":{"202":"3d97012f-af0e-4287-97e8-e176fcf9153a","400":"492cf3d9-f5a8-49bb-a67d-1f5402081b9c","401":"9a6a4007-360e-401b-84ff-074bc7d50e46","402":"5b77fd25-ce07-4552-bf6f-92ba1242b3aa","403":"e3561e6f-cd8b-4cc1-b531-cc642ba6459c","404":"6f29b42c-0d03-47d1-ab8b-e351fd22812a","409":"a1b327bb-2ee8-4fb3-9d2a-d29fc03de2f2","429":"81e19a86-6f02-431b-b8dd-ed290634affc"},"method":"post","type":"path","servers":["29d931c6-5fff-4863-8a8c-174d14bcfadc"],"security":["351696e4-4f48-437f-8252-dda2ec52bd76"],"path":"/api/v1/ditto","baseUrlOptions":["https://api.melius.com"],"title":"Create a Ditto video","description":"","codeSamples":[],"requestExampleLanguages":["bash","python","typescript","php","go","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c19d044a-f4ec-4983-a509-849b62a47302":{"in":"header","name":"idempotency-key","description":"A case-sensitive key for one intended submission: 1–255 ASCII letters, digits, periods, underscores, colons or hyphens. Reuse it for identical retries; use a fresh key for a new run.","schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]+$","minLength":1,"maxLength":255,"description":"A case-sensitive key for one intended submission: 1–255 ASCII letters, digits, periods, underscores, colons or hyphens. Reuse it for identical retries; use a fresh key for a new run.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"sourceAssetId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"sourceAssetId","typeLabel":"string\u003cuuid>"},"dittoTemplate":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"dittoTemplate.id","typeLabel":"string\u003cuuid>"},"revision":{"type":"integer","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"dittoTemplate.revision","typeLabel":"integer"}},"required":["id","revision"],"uniqueKey":"dittoTemplate","typeLabel":"object"},"styleId":{"type":"string","format":"uuid","description":"A Ditto style to re-render the whole source video in. Send no replacements with it.","uniqueKey":"styleId","typeLabel":"string\u003cuuid>"},"additionalInstructions":{"type":"string","maxLength":2000,"uniqueKey":"additionalInstructions","typeLabel":"string"},"sourceRange":{"type":"object","properties":{"startMs":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"sourceRange.startMs","typeLabel":"number"},"endMs":{"type":"number","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"sourceRange.endMs","typeLabel":"number"}},"required":["startMs","endMs"],"uniqueKey":"sourceRange","typeLabel":"object"},"modelId":{"type":"string","minLength":1,"maxLength":100,"uniqueKey":"modelId","typeLabel":"string"},"resolution":{"type":"string","enum":["480p","720p","1080p","480P","768P","1080P"],"uniqueKey":"resolution","typeLabel":"enum\u003cstring>"},"audioMode":{"type":"string","enum":["original","mute"],"default":"original","uniqueKey":"audioMode","typeLabel":"enum\u003cstring>"},"replacements":{"type":"array","items":{"type":"object","properties":{"targetKind":{"type":"string","enum":["character","prop","background"],"description":"What this reference image replaces in the source video.","isRequired":true,"uniqueKey":"replacements.items.[INDEX].targetKind","typeLabel":"enum\u003cstring>"},"referenceAssetId":{"type":"string","format":"uuid","description":"Image asset showing the replacement appearance for this item.","uniqueKey":"replacements.items.[INDEX].referenceAssetId","typeLabel":"string\u003cuuid>"},"targetDescription":{"type":"string","maxLength":1000,"description":"Optional description identifying the existing character, prop or background to replace.","uniqueKey":"replacements.items.[INDEX].targetDescription","typeLabel":"string"},"pendingAvatarRenderId":{"type":"string","format":"uuid","description":"A custom avatar render of this character that may still be in progress. The run waits a few minutes for it and uses its portrait in place of referenceAssetId if it finishes in time; otherwise it uses referenceAssetId.","uniqueKey":"replacements.items.[INDEX].pendingAvatarRenderId","typeLabel":"string\u003cuuid>"},"avatar":{"type":"object","properties":{"kind":{"type":"string","enum":["custom","curated"],"description":"custom for one of the team's Cast avatars; curated for a Melius avatar","isRequired":true,"uniqueKey":"replacements.items.[INDEX].avatar.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","description":"The avatar's id from GET /ditto/avatars.","isRequired":true,"uniqueKey":"replacements.items.[INDEX].avatar.id","typeLabel":"string\u003cuuid>"}},"required":["kind","id"],"description":"The avatar whose image referenceAssetId is. Prepare takes it in place of referenceAssetId and returns both; run checks the avatar still has that image.","uniqueKey":"replacements.items.[INDEX].avatar","typeLabel":"object"}},"required":["targetKind"],"uniqueKey":"replacements.items.[INDEX]","typeLabel":"object"},"maxItems":30,"default":[],"description":"What to replace, in order: each item names an image or an avatar. Leave it out for a style transfer or an edit described only in additionalInstructions.","uniqueKey":"replacements","typeLabel":"object[]"},"maxCredits":{"type":"number","minimum":0,"description":"The most credits this video may cost. A higher price answers 402 and starts nothing.","uniqueKey":"maxCredits","typeLabel":"number"}},"required":["sourceAssetId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sourceAssetId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","styleId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","additionalInstructions":"\u003cstring>","modelId":"\u003cstring>","audioMode":"original","replacements":[],"maxCredits":1}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3d97012f-af0e-4287-97e8-e176fcf9153a":{"description":"202","content":{"application/json":{"schema":{"type":"object","properties":{"generationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"generationId","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["preparing","rendering","finalizing","ready","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"input":{"oneOf":[{"type":"object","required":["sourceAssetId","audioMode","replacements"],"properties":{"sourceAssetId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"input.oneOf.0.sourceAssetId","typeLabel":"string\u003cuuid>"},"audioMode":{"type":"string","enum":["original","mute"],"default":"original","isRequired":true,"uniqueKey":"input.oneOf.0.audioMode","typeLabel":"enum\u003cstring>"},"replacements":{"type":"array","items":{"type":"object","properties":{"referenceAssetId":{"type":"string","format":"uuid","description":"Image asset showing the replacement appearance for this item.","isRequired":true,"uniqueKey":"input.oneOf.0.replacements.items.[INDEX].referenceAssetId","typeLabel":"string\u003cuuid>"},"targetKind":{"type":"string","enum":["character","prop","background"],"description":"What this reference image replaces in the source video.","isRequired":true,"uniqueKey":"input.oneOf.0.replacements.items.[INDEX].targetKind","typeLabel":"enum\u003cstring>"},"targetDescription":{"type":"string","maxLength":1000,"description":"Optional description identifying the existing character, prop or background to replace.","uniqueKey":"input.oneOf.0.replacements.items.[INDEX].targetDescription","typeLabel":"string"},"pendingAvatarRenderId":{"type":"string","format":"uuid","description":"A custom avatar render of this character that may still be in progress. The run waits a few minutes for it and uses its portrait in place of referenceAssetId if it finishes in time; otherwise it uses referenceAssetId.","uniqueKey":"input.oneOf.0.replacements.items.[INDEX].pendingAvatarRenderId","typeLabel":"string\u003cuuid>"},"avatar":{"type":"object","properties":{"kind":{"type":"string","enum":["custom","curated"],"description":"custom for one of the team's Cast avatars; curated for a Melius avatar","isRequired":true,"uniqueKey":"input.oneOf.0.replacements.items.[INDEX].avatar.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","description":"The avatar's id from GET /ditto/avatars.","isRequired":true,"uniqueKey":"input.oneOf.0.replacements.items.[INDEX].avatar.id","typeLabel":"string\u003cuuid>"}},"required":["kind","id"],"description":"The avatar whose image referenceAssetId is. Prepare takes it in place of referenceAssetId and returns both; run checks the avatar still has that image.","uniqueKey":"input.oneOf.0.replacements.items.[INDEX].avatar","typeLabel":"object"}},"required":["referenceAssetId","targetKind"],"uniqueKey":"input.oneOf.0.replacements.items.[INDEX]","typeLabel":"object"},"maxItems":30,"isRequired":true,"uniqueKey":"input.oneOf.0.replacements","typeLabel":"object[]"},"dittoTemplate":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"input.oneOf.0.dittoTemplate.id","typeLabel":"string\u003cuuid>"},"revision":{"type":"integer","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"input.oneOf.0.dittoTemplate.revision","typeLabel":"integer"}},"required":["id","revision"],"uniqueKey":"input.oneOf.0.dittoTemplate","typeLabel":"object"},"styleId":{"type":"string","format":"uuid","description":"A Ditto style to re-render the whole source video in. Send no replacements with it.","uniqueKey":"input.oneOf.0.styleId","typeLabel":"string\u003cuuid>"},"additionalInstructions":{"type":"string","maxLength":2000,"uniqueKey":"input.oneOf.0.additionalInstructions","typeLabel":"string"},"sourceRange":{"type":"object","properties":{"startMs":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"input.oneOf.0.sourceRange.startMs","typeLabel":"number"},"endMs":{"type":"number","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"input.oneOf.0.sourceRange.endMs","typeLabel":"number"}},"required":["startMs","endMs"],"uniqueKey":"input.oneOf.0.sourceRange","typeLabel":"object"},"modelId":{"type":"string","minLength":1,"maxLength":100,"uniqueKey":"input.oneOf.0.modelId","typeLabel":"string"},"resolution":{"type":"string","enum":["480p","720p","1080p","480P","768P","1080P"],"uniqueKey":"input.oneOf.0.resolution","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"input.oneOf.0","typeLabel":"object"},{"type":"object","required":["sourceAssetId","audioMode","referenceAssetId","targetKind"],"properties":{"sourceAssetId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"input.oneOf.1.sourceAssetId","typeLabel":"string\u003cuuid>"},"audioMode":{"type":"string","enum":["original","mute"],"default":"original","isRequired":true,"uniqueKey":"input.oneOf.1.audioMode","typeLabel":"enum\u003cstring>"},"referenceAssetId":{"type":"string","format":"uuid","description":"Image asset showing the replacement appearance for this item.","isRequired":true,"uniqueKey":"input.oneOf.1.referenceAssetId","typeLabel":"string\u003cuuid>"},"targetKind":{"type":"string","enum":["character","prop","background"],"description":"What this reference image replaces in the source video.","isRequired":true,"uniqueKey":"input.oneOf.1.targetKind","typeLabel":"enum\u003cstring>"},"dittoTemplate":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"input.oneOf.1.dittoTemplate.id","typeLabel":"string\u003cuuid>"},"revision":{"type":"integer","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"input.oneOf.1.dittoTemplate.revision","typeLabel":"integer"}},"required":["id","revision"],"uniqueKey":"input.oneOf.1.dittoTemplate","typeLabel":"object"},"styleId":{"type":"string","format":"uuid","description":"A Ditto style to re-render the whole source video in. Send no replacements with it.","uniqueKey":"input.oneOf.1.styleId","typeLabel":"string\u003cuuid>"},"additionalInstructions":{"type":"string","maxLength":2000,"uniqueKey":"input.oneOf.1.additionalInstructions","typeLabel":"string"},"sourceRange":{"type":"object","properties":{"startMs":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"input.oneOf.1.sourceRange.startMs","typeLabel":"number"},"endMs":{"type":"number","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"input.oneOf.1.sourceRange.endMs","typeLabel":"number"}},"required":["startMs","endMs"],"uniqueKey":"input.oneOf.1.sourceRange","typeLabel":"object"},"modelId":{"type":"string","minLength":1,"maxLength":100,"uniqueKey":"input.oneOf.1.modelId","typeLabel":"string"},"resolution":{"type":"string","enum":["480p","720p","1080p","480P","768P","1080P"],"uniqueKey":"input.oneOf.1.resolution","typeLabel":"enum\u003cstring>"},"targetDescription":{"type":"string","maxLength":1000,"description":"Optional description identifying the existing character, prop or background to replace.","uniqueKey":"input.oneOf.1.targetDescription","typeLabel":"string"},"pendingAvatarRenderId":{"type":"string","format":"uuid","description":"A custom avatar render of this character that may still be in progress. The run waits a few minutes for it and uses its portrait in place of referenceAssetId if it finishes in time; otherwise it uses referenceAssetId.","uniqueKey":"input.oneOf.1.pendingAvatarRenderId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"input.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"input","typeLabel":"object"},"canvasId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"canvasId","typeLabel":"string\u003cuuid>"},"sourceVideoUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"sourceVideoUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"sourceVideoUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sourceVideoUrl","typeLabel":"string | null"},"referenceImageUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"referenceImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"referenceImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"referenceImageUrl","typeLabel":"string | null"},"url":{"type":"string","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"bulkNodeRunId":{"type":"string","format":"uuid","uniqueKey":"bulkNodeRunId","typeLabel":"string\u003cuuid>"},"outputVersionId":{"type":"string","format":"uuid","uniqueKey":"outputVersionId","typeLabel":"string\u003cuuid>"},"outputAssetId":{"type":"string","format":"uuid","uniqueKey":"outputAssetId","typeLabel":"string\u003cuuid>"},"videoUrl":{"oneOf":[{"type":"string","uniqueKey":"videoUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"videoUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"videoUrl","typeLabel":"string | null"},"references":{"type":"array","items":{"type":"object","properties":{"referenceAssetId":{"type":"string","format":"uuid","description":"Image asset showing the replacement appearance for this item.","isRequired":true,"uniqueKey":"references.items.[INDEX].referenceAssetId","typeLabel":"string\u003cuuid>"},"targetKind":{"type":"string","enum":["character","prop","background"],"description":"What this reference image replaces in the source video.","isRequired":true,"uniqueKey":"references.items.[INDEX].targetKind","typeLabel":"enum\u003cstring>"},"imageUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"references.items.[INDEX].imageUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"references.items.[INDEX].imageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"references.items.[INDEX].imageUrl","typeLabel":"string | null"},"targetDescription":{"type":"string","maxLength":1000,"description":"Optional description identifying the existing character, prop or background to replace.","uniqueKey":"references.items.[INDEX].targetDescription","typeLabel":"string"},"pendingAvatarRenderId":{"type":"string","format":"uuid","description":"A custom avatar render of this character that may still be in progress. The run waits a few minutes for it and uses its portrait in place of referenceAssetId if it finishes in time; otherwise it uses referenceAssetId.","uniqueKey":"references.items.[INDEX].pendingAvatarRenderId","typeLabel":"string\u003cuuid>"},"avatar":{"type":"object","properties":{"kind":{"type":"string","enum":["custom","curated"],"description":"custom for one of the team's Cast avatars; curated for a Melius avatar","isRequired":true,"uniqueKey":"references.items.[INDEX].avatar.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","description":"The avatar's id from GET /ditto/avatars.","isRequired":true,"uniqueKey":"references.items.[INDEX].avatar.id","typeLabel":"string\u003cuuid>"}},"required":["kind","id"],"description":"The avatar whose image referenceAssetId is. Prepare takes it in place of referenceAssetId and returns both; run checks the avatar still has that image.","uniqueKey":"references.items.[INDEX].avatar","typeLabel":"object"}},"required":["referenceAssetId","targetKind","imageUrl"],"uniqueKey":"references.items.[INDEX]","typeLabel":"object"},"uniqueKey":"references","typeLabel":"object[]"},"canRetryFinalization":{"type":"boolean","uniqueKey":"canRetryFinalization","typeLabel":"boolean"},"retryQuoteId":{"type":"string","uniqueKey":"retryQuoteId","typeLabel":"string"},"failureMessage":{"type":"string","uniqueKey":"failureMessage","typeLabel":"string"},"gemsReturned":{"type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"gemsReturned","typeLabel":"integer"},"credits":{"type":"object","properties":{"charged":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"credits.charged","typeLabel":"integer"},"refunded":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"credits.refunded","typeLabel":"integer"}},"required":["charged","refunded"],"uniqueKey":"credits","typeLabel":"object"},"failureReason":{"type":"string","enum":["insufficient_credits","content_policy","no_media_generated","provider_error","validation_error","timeout","system","unknown"],"uniqueKey":"failureReason","typeLabel":"enum\u003cstring>"},"estimatedWait":{"type":"object","properties":{"lowSeconds":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"estimatedWait.lowSeconds","typeLabel":"number"},"highSeconds":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"estimatedWait.highSeconds","typeLabel":"number"}},"required":["lowSeconds","highSeconds"],"uniqueKey":"estimatedWait","typeLabel":"object"},"retryOf":{"type":"string","format":"uuid","uniqueKey":"retryOf","typeLabel":"string\u003cuuid>"}},"required":["generationId","status","input","canvasId","sourceVideoUrl","referenceImageUrl","url"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"generationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"preparing","input":{"sourceAssetId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","audioMode":"original","replacements":[{"referenceAssetId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","targetKind":"character","targetDescription":"\u003cstring>","pendingAvatarRenderId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","avatar":{"kind":"custom","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}],"dittoTemplate":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","revision":1},"styleId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","additionalInstructions":"\u003cstring>","sourceRange":{"startMs":1,"endMs":1},"modelId":"\u003cstring>","resolution":"480p"},"canvasId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","sourceVideoUrl":"\u003cstring>","referenceImageUrl":"\u003cstring>","url":"\u003cstring>","bulkNodeRunId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","outputVersionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","outputAssetId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","videoUrl":"\u003cstring>","references":[{"referenceAssetId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","targetKind":"character","imageUrl":"\u003cstring>","targetDescription":"\u003cstring>","pendingAvatarRenderId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","avatar":{"kind":"custom","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}],"canRetryFinalization":true,"retryQuoteId":"\u003cstring>","failureMessage":"\u003cstring>","gemsReturned":1,"credits":{"charged":1,"refunded":1},"failureReason":"insufficient_credits","estimatedWait":{"lowSeconds":1,"highSeconds":1},"retryOf":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}},"exampleType":"generated"}},"exampleType":"generated"},"492cf3d9-f5a8-49bb-a67d-1f5402081b9c":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9a6a4007-360e-401b-84ff-074bc7d50e46":{"description":"Missing, invalid, expired, or revoked API key.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"required":["statusCode","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"message":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5b77fd25-ce07-4552-bf6f-92ba1242b3aa":{"description":"402","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e3561e6f-cd8b-4cc1-b531-cc642ba6459c":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6f29b42c-0d03-47d1-ab8b-e351fd22812a":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"a1b327bb-2ee8-4fb3-9d2a-d29fc03de2f2":{"description":"409","headers":{"Retry-After":{"description":"Present for IDEMPOTENCY_REQUEST_IN_PROGRESS: wait one second, then retry with the same key and request.","schema":{"type":"integer","enum":[1]}}},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"code":{"type":"string","enum":["IDEMPOTENCY_KEY_REUSED","IDEMPOTENCY_REQUEST_IN_PROGRESS"],"isRequired":true,"uniqueKey":"oneOf.0.code","typeLabel":"enum\u003cstring>"},"retryAfterSeconds":{"type":"number","uniqueKey":"oneOf.0.retryAfterSeconds","typeLabel":"number"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"IDEMPOTENCY_KEY_REUSED","retryAfterSeconds":123}}},"exampleType":"generated"}},"exampleType":"generated"},"81e19a86-6f02-431b-b8dd-ed290634affc":{"description":"Rate limit reached — retry after the `Retry-After` header.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"retryAfterSeconds":{"type":"integer","uniqueKey":"retryAfterSeconds","typeLabel":"integer"}},"required":["statusCode","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"message":"\u003cstring>","error":"\u003cstring>","retryAfterSeconds":123}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"351696e4-4f48-437f-8252-dda2ec52bd76":{"apiKey":{"type":"http","scheme":"bearer","description":"A Melius API key (`mel_...`), sent as `Authorization: Bearer \u003ckey>`.","scopes":[],"schemeName":"apiKey"},"teamId":{"type":"apiKey","in":"header","name":"x-team-id","description":"The team (workspace) to act on. Defaults to the key's team when omitted.","scopes":[],"schemeName":"teamId"}}},"servers":{"29d931c6-5fff-4863-8a8c-174d14bcfadc":{"url":"https://api.melius.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A Melius API key (`mel_...`), sent as `Authorization: Bearer \u003ckey>`.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A Melius API key (`mel_...`), sent as `Authorization: Bearer \u003ckey>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"},{"scheme":{"type":"apiKey","in":"header","name":"x-team-id","description":"The team (workspace) to act on. Defaults to the key's team when omitted.","scopes":[],"schemeName":"teamId"},"schema":{"title":"x-team-id","type":"string","description":"The team (workspace) to act on. Defaults to the key's team when omitted.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"teamId","name":"x-team-id"}],"title":"apiKey \u0026 teamId"}]},"originalFileLocation":"api/openapi.json"},"subdomain":"melius","siteName":"Melius docs","title":"Create a Ditto video - Melius docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/ditto/create-a-ditto-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=\"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=\"application-name\" content=\"Melius 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/melius/48ps5MoSVa4uDyAz/_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/melius/48ps5MoSVa4uDyAz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/melius/48ps5MoSVa4uDyAz/_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/melius/48ps5MoSVa4uDyAz/_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/melius/48ps5MoSVa4uDyAz/_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/melius/48ps5MoSVa4uDyAz/_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/melius/48ps5MoSVa4uDyAz/_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/melius/48ps5MoSVa4uDyAz/_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/melius/48ps5MoSVa4uDyAz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Ditto video - Melius docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Melius docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://melius.mintlify.site/_mintlify/api/og/v2?division=Ditto\u0026amp;title=Create+a+Ditto+video\u0026amp;theme=a47bfae0882125d0f897da69\u0026amp;signature=43fcee324e8b9d916896aba9d43a3c7ed5b28348a8ba0ff70ae470efe1cbc585\">\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=\"Create a Ditto video - Melius docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://melius.mintlify.site/_mintlify/api/og/v2?division=Ditto\u0026amp;title=Create+a+Ditto+video\u0026amp;theme=a47bfae0882125d0f897da69\u0026amp;signature=43fcee324e8b9d916896aba9d43a3c7ed5b28348a8ba0ff70ae470efe1cbc585\">\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/melius/48ps5MoSVa4uDyAz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Melius docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ditto/create-a-ditto-video.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.melius.com/#organization\",\"name\":\"Melius docs\",\"url\":\"https://docs.melius.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/melius/Iumd0dzsPc4PNcYZ/logo/melius-logo.svg?fit=max\u0026auto=format\u0026n=Iumd0dzsPc4PNcYZ\u0026q=85\u0026s=cff8b577f5dd7d6a49ade2a06ce020d8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.melius.com#website\",\"name\":\"Melius docs\",\"url\":\"https://docs.melius.com\",\"publisher\":{\"@id\":\"https://docs.melius.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video#webpage\",\"url\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video\",\"name\":\"Create a Ditto video\",\"isPartOf\":{\"@id\":\"https://docs.melius.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ditto\",\"item\":\"https://docs.melius.com/api-reference/ditto/list-ditto-models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Ditto video\",\"item\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video#apireference\",\"headline\":\"Create a Ditto video\",\"name\":\"Create a Ditto video\",\"url\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video\",\"mainEntityOfPage\":{\"@id\":\"https://docs.melius.com/api-reference/ditto/create-a-ditto-video#webpage\"},\"publisher\":{\"@id\":\"https://docs.melius.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.melius.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Melius docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Melius docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/ditto/create-a-ditto-video.md","siteName":"Melius docs","nav":{"global":null,"tabs":[{"tab":"Getting started","pages":[{"title":"Getting started","href":""}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"API/CLI","groups":[{"group":"Get started","pages":[{"title":"API overview","href":"/api/overview"},{"title":"Quickstart","href":"/api/quickstart"},{"title":"Authentication","href":"/api/authentication"},{"title":"Ditto","href":"/api/ditto"}]},{"group":"CLI","pages":[{"title":"CLI overview","href":"/cli/overview"},{"title":"Installation","href":"/cli/installation"},{"title":"Quickstart","href":"/cli/quickstart"},{"title":"Command reference","href":"/cli/commands"},{"title":"Using mel from an agent","href":"/cli/agents"}]},{"group":"Projects","pages":[{"title":"Create a project","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/projects","href":"/api-reference/project/create-a-project"},{"title":"List projects","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/projects/all","href":"/api-reference/project/list-projects"},{"title":"Get a project","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/projects/{projectId}","href":"/api-reference/project/get-a-project"},{"title":"Update a project","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/projects/{projectId}","href":"/api-reference/project/update-a-project"},{"title":"Delete a project","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /api/v1/projects/{projectId}","href":"/api-reference/project/delete-a-project"}]},{"group":"Canvases","pages":[{"title":"Create a canvas","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/projects/{projectId}/canvases","href":"/api-reference/canvas/create-a-canvas"},{"title":"List canvases in a project","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/projects/{projectId}/canvases","href":"/api-reference/canvas/list-canvases-in-a-project"},{"title":"List all canvases","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/canvases","href":"/api-reference/canvas/list-all-canvases"},{"title":"Get a canvas","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/canvases/{canvasId}","href":"/api-reference/canvas/get-a-canvas"},{"title":"Update a canvas","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/canvases/{canvasId}","href":"/api-reference/canvas/update-a-canvas"},{"title":"Delete a canvas","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /api/v1/projects/{projectId}/canvases/{canvasId}","href":"/api-reference/canvas/delete-a-canvas"},{"title":"Get canvas content","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/canvases/{canvasId}/content","href":"/api-reference/canvas/get-canvas-content"}]},{"group":"Nodes","pages":[{"title":"Get a node","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/nodes/{nodeId}","href":"/api-reference/node/get-a-node"},{"title":"Create a node","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/direct/nodes","href":"/api-reference/node/create-a-node"},{"title":"Update a node","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/canvases/{canvasId}/direct/nodes/{nodeId}","href":"/api-reference/node/update-a-node"},{"title":"Delete a node","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /api/v1/canvases/{canvasId}/direct/nodes/{nodeId}","href":"/api-reference/node/delete-a-node"},{"title":"Create nodes in bulk","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/direct/nodes/bulk","href":"/api-reference/node/create-nodes-in-bulk"},{"title":"Update nodes in bulk","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/canvases/{canvasId}/direct/nodes/bulk","href":"/api-reference/node/update-nodes-in-bulk"},{"title":"Delete nodes in bulk","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/direct/nodes/bulk-delete","href":"/api-reference/node/delete-nodes-in-bulk"},{"title":"Set node text","deprecated":null,"version":null,"openapi":"/api/openapi.json put /api/v1/nodes/{nodeId}/custom-text","href":"/api-reference/node/set-node-text"},{"title":"Set the active node version","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/nodes/{nodeId}/set-version","href":"/api-reference/node/set-the-active-node-version"}]},{"group":"Sticky notes","pages":[{"title":"Create a sticky note","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/direct/notes","href":"/api-reference/note/create-a-sticky-note"},{"title":"Update a sticky note","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/canvases/{canvasId}/direct/notes/{noteId}","href":"/api-reference/note/update-a-sticky-note"}]},{"group":"Edges","pages":[{"title":"Create an edge","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/direct/edges","href":"/api-reference/edge/create-an-edge"},{"title":"Delete an edge","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /api/v1/canvases/{canvasId}/direct/edges/{edgeId}","href":"/api-reference/edge/delete-an-edge"},{"title":"Create edges in bulk","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/direct/edges/bulk","href":"/api-reference/edge/create-edges-in-bulk"}]},{"group":"Runs","pages":[{"title":"Start a run","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/nodes/{nodeId}/runs","href":"/api-reference/run/start-a-run"},{"title":"Run a node tool","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/nodes/{nodeId}/tool-runs","href":"/api-reference/run/run-a-node-tool"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/node-runs/{nodeRunId}","href":"/api-reference/run/get-a-run"},{"title":"Cancel a run","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/node-runs/{nodeRunId}/cancel","href":"/api-reference/run/cancel-a-run"},{"title":"Get the latest runs","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/canvases/{canvasId}/node-runs/latest","href":"/api-reference/run/get-the-latest-runs"},{"title":"Start a bulk run","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/bulk-run","href":"/api-reference/run/start-a-bulk-run"},{"title":"Get a bulk run","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/bulk-node-runs/{bulkNodeRunId}","href":"/api-reference/run/get-a-bulk-run"},{"title":"Download a run output","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/node-runs/{nodeRunId}/download","href":"/api-reference/run/download-a-run-output"},{"title":"Download all run outputs","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/node-runs/download","href":"/api-reference/run/download-all-run-outputs"},{"title":"Download a bulk run output","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/bulk-node-runs/{bulkNodeRunId}/download","href":"/api-reference/run/download-a-bulk-run-output"},{"title":"Magic resize from an image","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/magic-resize","href":"/api-reference/run/magic-resize-from-an-image"}]},{"group":"Ditto","pages":[{"title":"List Ditto models","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/ditto/models","href":"/api-reference/ditto/list-ditto-models"},{"title":"List Ditto avatars","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/ditto/avatars","href":"/api-reference/ditto/list-ditto-avatars"},{"title":"Create a Ditto video","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/ditto","href":"/api-reference/ditto/create-a-ditto-video"},{"title":"Get a Ditto video","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/ditto/{generationId}","href":"/api-reference/ditto/get-a-ditto-video"}]},{"group":"Comments","pages":[{"title":"Create a comment thread","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/comment-threads","href":"/api-reference/comment/create-a-comment-thread"},{"title":"List comment threads","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/canvases/{canvasId}/comment-threads","href":"/api-reference/comment/list-comment-threads"},{"title":"Update a comment thread","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/comment-threads/{threadId}","href":"/api-reference/comment/update-a-comment-thread"},{"title":"Add a comment to a thread","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/comment-threads/{threadId}/comments","href":"/api-reference/comment/add-a-comment-to-a-thread"}]},{"group":"Presence","pages":[{"title":"Set agent presence","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/agent-presence","href":"/api-reference/presence/set-agent-presence"}]},{"group":"Uploads","pages":[{"title":"Start an upload","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/upload/init","href":"/api-reference/upload/start-an-upload"},{"title":"Sign an upload part","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/upload/sign-part","href":"/api-reference/upload/sign-an-upload-part"},{"title":"Complete an upload","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/upload/complete","href":"/api-reference/upload/complete-an-upload"}]},{"group":"Assets","pages":[{"title":"Search team assets for the agent","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/files/agent-search","href":"/api-reference/asset/search-team-assets-for-the-agent"},{"title":"List team asset folders for the agent","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/files/agent-folders","href":"/api-reference/asset/list-team-asset-folders-for-the-agent"},{"title":"Place library assets onto a canvas","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/canvases/{canvasId}/library-assets/place","href":"/api-reference/asset/place-library-assets-onto-a-canvas"}]},{"group":"Models","pages":[{"title":"List generative models","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/generation/models","href":"/api-reference/model/list-generative-models"},{"title":"Get Auto model defaults","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/generation/auto-model-defaults","href":"/api-reference/model/get-auto-model-defaults"}]},{"group":"Audio","pages":[{"title":"List voices","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/audio/voices","href":"/api-reference/audio/list-voices"}]},{"group":"Fonts","pages":[{"title":"List custom fonts","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/custom-fonts","href":"/api-reference/font/list-custom-fonts"}]},{"group":"Presets","pages":[{"title":"List presets","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/presets","href":"/api-reference/preset/list-presets"}]},{"group":"Templates","pages":[{"title":"List templates","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/templates","href":"/api-reference/template/list-templates"},{"title":"Apply a template","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/templates/apply","href":"/api-reference/template/apply-a-template"}]},{"group":"Teams","pages":[{"title":"List your teams","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/teams","href":"/api-reference/team/list-your-teams"}]},{"group":"Team skills","pages":[{"title":"List team skills","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/teams/{teamId}/agent-skills","href":"/api-reference/teamskill/list-team-skills"},{"title":"Get a team skill","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/teams/{teamId}/agent-skills/{skillId}","href":"/api-reference/teamskill/get-a-team-skill"},{"title":"Create a team skill","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/teams/{teamId}/agent-skills","href":"/api-reference/teamskill/create-a-team-skill"},{"title":"Update a team skill","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/teams/{teamId}/agent-skills/{skillId}","href":"/api-reference/teamskill/update-a-team-skill"},{"title":"Delete a team skill","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /api/v1/teams/{teamId}/agent-skills/{skillId}","href":"/api-reference/teamskill/delete-a-team-skill"},{"title":"Start a team skill image upload","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/teams/{teamId}/agent-skills/{skillId}/assets/init","href":"/api-reference/teamskill/start-a-team-skill-image-upload"},{"title":"Sign a team skill image upload part","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/teams/{teamId}/agent-skills/{skillId}/assets/sign-part","href":"/api-reference/teamskill/sign-a-team-skill-image-upload-part"},{"title":"Complete a team skill image upload","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/teams/{teamId}/agent-skills/{skillId}/assets/complete","href":"/api-reference/teamskill/complete-a-team-skill-image-upload"},{"title":"Update a team skill image","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /api/v1/teams/{teamId}/agent-skills/{skillId}/assets/{assetId}","href":"/api-reference/teamskill/update-a-team-skill-image"},{"title":"Remove a team skill image","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /api/v1/teams/{teamId}/agent-skills/{skillId}/assets/{assetId}","href":"/api-reference/teamskill/remove-a-team-skill-image"}]},{"group":"Profile","pages":[{"title":"Get your profile","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/profile/me","href":"/api-reference/profile/get-your-profile"}]},{"group":"Approvals","pages":[{"title":"Get a run approval","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/agent/approvals/{approvalId}","href":"/api-reference/approval/get-a-run-approval"}]},{"group":"API keys","pages":[{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/api/openapi.json post /api/v1/api-keys","href":"/api-reference/apikey/create-an-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api/openapi.json get /api/v1/api-keys","href":"/api-reference/apikey/list-api-keys"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /api/v1/api-keys/{keyId}","href":"/api-reference/apikey/revoke-an-api-key"}]}]},{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help-center/marketers/welcome"}]}]},"basePath":"","title":"Create a Ditto video - Melius docs","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}