> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ekly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Genjutsu Object Swap

> Swap an object in a clip you already have for the one in your reference images — a product, a prop, a garment — while the rest of the shot stays as filmed.

Swap an object in a clip you already have for the one in your reference images — a product, a prop, a garment — while the rest of the shot stays as filmed. Billed per second of the video you attach.

| | |
| - | - |
| Model id | `genjutsu-object-swap` |
| Media | video |
| Submit to | `POST /v1/videos` |
| Price | 37.46 credits per\_second before discounts |
| Typical time | about 240.0 s |

## Request

**Required:** `prompt`, `reference_images`, `source_video`\
**Optional:** `quality`

```json theme={null}
{
  "model": "genjutsu-object-swap",
  "prompt": "Replace the bottle on the table with the one in the reference image",
  "quality": "720p",
  "reference_images": [
    "asset_…"
  ],
  "source_video": "asset_…"
}
```

| Field | Allowed | Default |
| - | - | - |
| `quality` | `720p`, `480p` | `"720p"` |
| `reference_images` | asset ids (up to 8) | |
| `source_video` | asset id (up to 1) | |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/genjutsu-object-swap` is always current.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.