---
title: "Inspect replacement inputs and quote without starting paid work"
method: POST
path: "/api/v1/cast/replacements/prepare"
tags: ["castReplacement"]
deprecated: true
---

# Inspect replacement inputs and quote without starting paid work

`POST /api/v1/cast/replacements/prepare`

## Request

- Base URL: `https://api.melius.com`
- URL: `https://api.melius.com/api/v1/cast/replacements/prepare`
- Auth: HTTP bearer and API key in header `x-team-id`

> **Deprecated.**

## Request body

- union
  - object
    - `sourceAssetId` string, uuid, required
    - `dittoTemplate` object
      - `id` string, uuid, required
      - `revision` integer, required
    - `additionalInstructions` string
    - `sourceRange` object
      - `startMs` number, required
      - `endMs` number, required
    - `modelId` string
    - `resolution` '480p' | '720p' | '1080p' | '480P' | '768P' | '1080P'
    - `audioMode` 'original' | 'mute'
    - `replacements` object[], required
      - `referenceAssetId` string, uuid, required: Image asset showing the replacement appearance for this item.
      - `targetKind` 'character' | 'prop' | 'background', required: What this reference image replaces in the source video.
      - `targetDescription` string: Optional description identifying the existing character, prop or background to replace.
  - object
    - `sourceAssetId` string, uuid, required
    - `dittoTemplate` object
      - `id` string, uuid, required
      - `revision` integer, required
    - `additionalInstructions` string
    - `sourceRange` object
      - `startMs` number, required
      - `endMs` number, required
    - `modelId` string
    - `resolution` '480p' | '720p' | '1080p' | '480P' | '768P' | '1080P'
    - `audioMode` 'original' | 'mute'
    - `referenceAssetId` string, uuid, required: Image asset showing the replacement appearance for this item.
    - `targetKind` 'character' | 'prop' | 'background', required: What this reference image replaces in the source video.
    - `targetDescription` string: Optional description identifying the existing character, prop or background to replace.

## Response `200`

200

- object
  - `input` union, required
    - object
      - `sourceAssetId` string, uuid, required
      - `dittoTemplate` object
        - `id` string, uuid, required
        - `revision` integer, required
      - `additionalInstructions` string
      - `sourceRange` object
        - `startMs` number, required
        - `endMs` number, required
      - `modelId` string
      - `resolution` '480p' | '720p' | '1080p' | '480P' | '768P' | '1080P'
      - `audioMode` 'original' | 'mute', required
      - `replacements` object[], required
        - `referenceAssetId` string, uuid, required: Image asset showing the replacement appearance for this item.
        - `targetKind` 'character' | 'prop' | 'background', required: What this reference image replaces in the source video.
        - `targetDescription` string: Optional description identifying the existing character, prop or background to replace.
    - object
      - `sourceAssetId` string, uuid, required
      - `dittoTemplate` object
        - `id` string, uuid, required
        - `revision` integer, required
      - `additionalInstructions` string
      - `sourceRange` object
        - `startMs` number, required
        - `endMs` number, required
      - `modelId` string
      - `resolution` '480p' | '720p' | '1080p' | '480P' | '768P' | '1080P'
      - `audioMode` 'original' | 'mute', required
      - `referenceAssetId` string, uuid, required: Image asset showing the replacement appearance for this item.
      - `targetKind` 'character' | 'prop' | 'background', required: What this reference image replaces in the source video.
      - `targetDescription` string: Optional description identifying the existing character, prop or background to replace.
  - `sourceDurationMs` number, nullable, required
  - `selectedDurationMs` number, nullable, required
  - `sourceVideoUrl` string, nullable, required
  - `referenceImageUrl` string, nullable, required
  - `references` object[]
    - `referenceAssetId` string, uuid, required: Image asset showing the replacement appearance for this item.
    - `targetKind` 'character' | 'prop' | 'background', required: What this reference image replaces in the source video.
    - `targetDescription` string: Optional description identifying the existing character, prop or background to replace.
    - `imageUrl` string, nullable, required
  - `models` object[], required
    - `modelId` string, required
    - `label` string, required
    - `eligible` boolean, required
    - `reasons` object[], required
      - `code` string, required
      - `message` string, required
      - `measured` number
      - `minimum` number
      - `maximum` number
    - `resolutions` string[], required
    - `sourceDurationLimits` object
      - `minimumMs` number, nullable, required
      - `maximumMs` number, required
  - `quote` object, nullable, required
    - `id` string, required
    - `expiresAt` string, date-time, required
    - `credits` number, required

## Other responses

- `400`: 400
- `401`: Missing, invalid, expired, or revoked API key.
- `403`: 403
- `404`: 404
- `429`: Rate limit reached — retry after the `Retry-After` header.

## Changes

- **2026-11-03** `2a857511f605`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/melius/apis/melius-api/changes/api/v1/cast/replacements/prepare/post.md)

---

[API](https://skmtc.dev/melius/apis/melius-api.md) - [All operations](https://skmtc.dev/melius/apis/melius-api/llms.txt) - [OpenAPI document](https://skmtc.dev/melius/apis/melius-api/revisions/2a857511f605?raw)