---
title: "Genjutsu Motion Transfer"
description: "Transfer the movements from a source video to the person in reference photos"
sidebar:
  label: "Motion Transfer"
seo:
  title: "Genjutsu Motion Transfer API Documentation: Parameters & Examples"
  description: "Genjutsu Motion Transfer API documentation: model ID higgsfield/genjutsu-1.0-motion-transfer, input modes, parameters, defaults and request examples. Transfer the movements from a source video to the person in reference photos."
---

{/* Generated by scripts/generate-model-pages.mjs from openapi/model-contracts.json. Do not edit; write notes in docs/models/_notes/nanoapi/genjutsu-1-0.mdx */}

| Request `model` | Endpoint |
| --- | --- |
| `higgsfield/genjutsu-1.0-motion-transfer` | [Video generation](/docs/guides/video-generation) |

## Input modes

| Mode | References | Reference roles |
| --- | --- | --- |
| `reference` Reference media | 2 to 11 | `reference_image` 1 to 10<br />`reference_video` 1 |

Text is optional in these input modes on explicitly supported channels: `reference`

Prompt limit: 5,000 characters; longer prompts are rejected with 400.

## Parameters

| Parameter | Description | Values | Default | Required |
| --- | --- | --- | --- | --- |
| `duration` | Duration: Output video duration in seconds. | `1` to `30` | `5` | No |
| `resolution` | Resolution: Output resolution. | `480p`, `720p`, `1080p` | `720p` | No |
| `aspect_ratio` | Aspect ratio: Output aspect ratio. | `auto` | `auto` | No |
| `generate_audio` | Generate audio: Generate native audio with the video. | `false` | `false` | No |
| `n` | Outputs per request: Number of outputs from one API request (one Job), not the application batch size. For multiple Jobs, submit separate requests; n=1 does not prevent application-managed batching. | `1` | `1` | No |

## Examples

`reference` input:

```json
{
  "model": "higgsfield/genjutsu-1.0-motion-transfer",
  "input": {
    "type": "reference",
    "prompt": "A paper boat drifting down a rainy city street, slow tracking shot",
    "references": [
      {
        "role": "reference_image",
        "file_id": "file_..."
      },
      {
        "role": "reference_video",
        "file_id": "file_..."
      }
    ]
  },
  "parameters": {
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": false,
    "n": 1
  }
}
```

The authoritative contract is `GET /v1/models/higgsfield/genjutsu-1.0-motion-transfer?view=contract`. A valid parameter does not mean every channel can run it, so [quote](/docs/concepts/billing#get-a-quote) the complete request. Prices and channels are listed in [Model Market](https://yir.ai/models).

## Source video and billing

Genjutsu transfers motion from one source video to the people in 1–10 reference images. Upload a 1–30 second MP4 using [Files](/docs/guides/input-files).

To replace an object in the source video, choose [Genjutsu Object Swap](/docs/models/higgsfield/genjutsu/object-swap) or [Genjutsu Light Object Swap](/docs/models/higgsfield/genjutsu-light/object-swap). See [the Genjutsu request examples](/docs/guides/video-generation#genjutsu-motion-transfer-and-object-swap).

The output duration and aspect ratio follow the source video. `duration` is a catalog representative value; it is not sent to the model and does not trim the video. Audio cannot be controlled: `generate_audio: true` is rejected, while `false` does not guarantee a silent result. Check the delivered file for an audio track.

Quotes use the longer of the measured audio and video tracks, rounded to the nearest second with a four-second minimum. Reference media have no additional fee. A URL that has not yet been imported has no complete quote; use a newly uploaded, measured file for an estimate. Final charges use the actual task cost.

## Compatible request names

Submit and quote requests also accept `genjutsu-1.0`, `nanoapi/genjutsu-1.0`.
