idpath · RequiredResource identifier returned by the corresponding create operation.
/api/v1/mv/drafts/{id}/preflightAuthentication · x-api-key
Validate a saved draft revision and return a full-video estimate and preflight receipt without purchasing generation.
idpath · RequiredResource identifier returned by the corresponding create operation.
Unknown fields are not accepted.
expectedVersionRequiredOptimistic-concurrency guard using the current resource version.
Minimum: 1. Must match at least one alternative.
expectedVersion · anyOf 1AlternativeFormat: integer. Default: 0.
expectedVersion · anyOf 2AlternativeMinimum: 1.
webhookUrlOptionalOptional HTTPS endpoint for the generated Task's completion notification.
Format: uri.
application/json
Unknown fields are not accepted.
checksRequiredUnknown fields are not accepted.
checks.referenceImagesRequiredchecks.referenceImages[]Each itemchecks.referenceImages[].kindRequiredchecks.referenceImages[].statusRequiredchecks.referenceImages[].clipIdOptionalchecks.referenceImages[].durationSecOptionalchecks.referenceImages[].processingModeOptionalchecks.referenceImages[].rangeOptionalchecks.referenceImages[].range.endSecOptionalMinimum: 0.
checks.referenceImages[].range.endSecSee schemaExpand this value in the interactive reference.
Minimum: 0.
checks.referenceImages[].range.startSecOptionalMinimum: 0.
checks.referenceImages[].range.startSecSee schemaExpand this value in the interactive reference.
Minimum: 0.
checks.referenceImages[].sourceDurationSecOptionalchecks.referenceImages[].urlOptionalchecks.sourceRequiredchecks.source.kindRequiredchecks.source.statusRequiredchecks.source.clipIdOptionalchecks.source.durationSecOptionalchecks.source.processingModeOptionalchecks.source.rangeOptionalchecks.source.range.endSecOptionalMinimum: 0.
checks.source.range.startSecOptionalMinimum: 0.
checks.source.sourceDurationSecOptionalchecks.source.urlOptionalchecks.characterImageOptionalchecks.characterImage.kindRequiredchecks.characterImage.statusRequiredchecks.characterImage.clipIdOptionalchecks.characterImage.durationSecOptionalchecks.characterImage.processingModeOptionalchecks.characterImage.rangeOptionalchecks.characterImage.range.endSecOptionalMinimum: 0.
checks.characterImage.range.startSecOptionalMinimum: 0.
checks.characterImage.sourceDurationSecOptionalchecks.characterImage.urlOptionalchecks.srtUrlOptionalchecks.srtUrl.kindRequiredchecks.srtUrl.statusRequiredchecks.srtUrl.clipIdOptionalchecks.srtUrl.durationSecOptionalchecks.srtUrl.processingModeOptionalchecks.srtUrl.rangeOptionalchecks.srtUrl.range.endSecOptionalMinimum: 0.
checks.srtUrl.range.startSecOptionalMinimum: 0.
checks.srtUrl.sourceDurationSecOptionalchecks.srtUrl.urlOptionalchecks.visualBoardOptionalchecks.visualBoard.kindRequiredchecks.visualBoard.statusRequiredchecks.visualBoard.clipIdOptionalchecks.visualBoard.durationSecOptionalchecks.visualBoard.processingModeOptionalchecks.visualBoard.rangeOptionalchecks.visualBoard.range.endSecOptionalMinimum: 0.
checks.visualBoard.range.startSecOptionalMinimum: 0.
checks.visualBoard.sourceDurationSecOptionalchecks.visualBoard.urlOptionalcreditsRequiredRequiredMinimum: 0.
expiresAtRequiredmodeRequiredpreflightIdRequiredquoteRequiredUnknown fields are not accepted.
quote.breakdownRequiredUnknown fields are not accepted.
quote.breakdown.baseOptionalquote.breakdown.composeOperationsOptionalquote.breakdown.durationOptionalquote.breakdown.estimatedSceneCountOptionalquote.breakdown.finalizeOptionalquote.breakdown.lipSyncOptionalquote.breakdown.renderPerSceneOptionalquote.breakdown.scenesOptionalquote.breakdown.visualBoardOptionalquote.creditsRequiredMinimum: 0.
quote.assumptionsOptionalquote.assumptions[]Each itemquote.baseCreditsOptionalquote.billingIncrementCreditsOptionalMinimum: 0.0001.
quote.calculatedSubtotalCreditsOptionalquote.componentsOptionalquote.components[]Each itemUnknown fields are not accepted.
quote.components[].discountCreditsRequiredquote.components[].discountedCreditsRequiredquote.components[].finalCreditsRequiredquote.components[].keyRequiredquote.components[].labelRequiredquote.components[].publicCreditsRequiredquote.components[].quantityOptionalquote.discountCreditsOptionalquote.expiresAtOptionalquote.operationOptionalquote.pricingVersionOptionalquote.quoteIdOptionalquote.settlementPolicyVersionOptionalquote.settlementRoundingCreditsOptionalquote.warningCodesOptionalquote.warningCodes[]Each itemMV advisory warning codes. Non-fatal: the request still succeeds; these flag degraded, adjusted, or automatically recovered inputs and are projected into public Task warningCodes. Omn review codes (MV_NATIVE_CREATIVE_*, MV_NATIVE_SHOT_INTERNAL_CUT, MV_NATIVE_FRAME_BORDERS) describe the delivered video; their observations and affected scenes are in `quality` of GET /api/v1/tasks/{taskId}/workflow.
quoteTypeRequiredwarningCodesRequiredwarningCodes[]Each itemMV advisory warning codes. Non-fatal: the request still succeeds; these flag degraded, adjusted, or automatically recovered inputs and are projected into public Task warningCodes. Omn review codes (MV_NATIVE_CREATIVE_*, MV_NATIVE_SHOT_INTERNAL_CUT, MV_NATIVE_FRAME_BORDERS) describe the delivered video; their observations and affected scenes are in `quality` of GET /api/v1/tasks/{taskId}/workflow.
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
Request allowance or task admission capacity exceeded. Follow Retry-After when present; otherwise wait for active tasks and use bounded backoff. Limits do not guarantee throughput. For SSE, this is the HTTP connection response, not an event.
application/json
errorRequirederror.codeRequiredRATE_LIMITED for request and task admission rejections.
error.messageRequirederror.detailsOptionalOptional and scope-dependent. Request limits supply scope/policy/type/limit/current/retryAfterSec. Task admission supplies inFlight/limit/tier, plus scope=apiKey for a key cap. IP rejection can omit details. In-flight rejection does not promise Retry-After.
error.details.currentOptionalMinimum: 0.
error.details.inFlightOptionalMinimum: 0.
error.details.limitOptionalMinimum: 0.
error.details.policyOptionalerror.details.retryAfterSecOptionalMinimum: 1.
error.details.scopeOptionalerror.details.tierOptionalerror.details.typeOptionalsuccessRequiredDefault: false.
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses
application/json
errorRequirederror.codeRequiredApplication-specific error code (see error catalog)
error.messageRequiredHuman readable error message
error.detailsOptionalAdditional error details (optional)
successRequiredAlways false for error responses