Genjutsu Motion Transfer
Genjutsu Motion Transfer API by Higgsfield. AI motion transfer: take the motion from a source video and apply it to the character in your reference image.
Pricing, live playground and model overview: Genjutsu Motion Transfer API on YepAPI
/v1/media/queueOverview
Higgsfield's Genjutsu Motion Transfer — AI motion transfer. Send a source video and a reference image; the output replays the source video's motion with the character or scene from your image. Async operation — submit a job, poll for completion.
| Property | Value |
|---|---|
| Model ID | higgsfield/genjutsu-motion-transfer |
| Alias | genjutsu, motion-transfer |
| Provider | Higgsfield |
| Inputs | source video |
| Resolutions | 720p, 480p, 1080p |
| Source Video | Public MP4 or MOV URL, at least 4 seconds |
| Billing | Per job — priced when queued, charged only on success |
| Pricing | from $0.636/source second |
Usage
All media models use the async job queue. Submit a job, then poll for the result.
Step 1: Submit Job
Source video + reference image
Send the source video as a public MP4 or MOV URL in options.referenceVideoUrl, and the reference image (the character or scene that should perform the motion) in imageData. Both are required.
const res = await fetch('https://api.yepapi.com/v1/media/queue', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'higgsfield/genjutsu-motion-transfer',
prompt: 'Make the character in the reference image perform this dance',
options: {
resolution: '720p',
referenceVideoUrl: 'https://example.com/source.mp4', // public MP4 or MOV URL
},
imageData: {
mimeType: 'image/png',
base64: '...', // Base64-encoded image
},
}),
});
const { data } = await res.json();
// data.jobId — use this to poll for resultscurl -X POST https://api.yepapi.com/v1/media/queue \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "higgsfield/genjutsu-motion-transfer", "prompt": "Make the character in the reference image perform this dance", "options": {"resolution": "720p", "referenceVideoUrl": "https://example.com/source.mp4"}, "imageData": {"mimeType": "image/png", "base64": "..."}}'Step 2: Poll for Result
const status = await fetch(`https://api.yepapi.com/v1/media/status/${data.jobId}`, {
headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status — "pending" | "processing" | "completed" | "failed"
// job.result.video — { mimeType, base64 } when completedcurl https://api.yepapi.com/v1/media/status/JOB_ID \
-H "x-api-key: YOUR_API_KEY"Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
model | string | Yes | higgsfield/genjutsu-motion-transfer or aliases genjutsu, motion-transfer | — |
prompt | string | Yes | Short instruction for the motion transfer | — |
options.resolution | string | No | 720p, 480p, 1080p | 720p |
options.referenceVideoUrl | string | Yes | Public MP4 or MOV URL of the source video | — |
imageData.mimeType | string | Yes | MIME type of input image (image/png, image/jpeg, image/webp) | — |
imageData.base64 | string | Yes | Base64-encoded reference image (character or scene to animate) | — |
Options are validated when you submit: an unsupported duration, resolution or value returns 400 naming the allowed values.
Features
- Motion from a source video (
options.referenceVideoUrl) - Character or scene from a reference image (
imageData) - 480p, 720p or 1080p
- Billed per second of source video
Pricing
| Resolution | Cost per second of source video |
|---|---|
| 480p | $0.636 |
| 720p | $1.362 |
| 1080p | $3.264 |
Billed on the source video's length, rounded up to whole seconds. Example: 10-second source at 720p = 10 × $1.362 = $13.62. Each job is priced when it's queued and charged only if it succeeds — failed or moderated jobs are free. Use Genjutsu Light for a lower-cost version.
Video jobs can take several minutes to complete. When capacity is busy, jobs wait in the queue (status stays pending or processing) — no action needed. Results retained for 1 hour.
The source video must be reachable at a public URL (MP4 or MOV). Pricing follows the source video's length, not the output.
Powered by Higgsfield's Genjutsu Motion Transfer via our AI provider.
PixVerse V6
PixVerse V6 API. Text-to-video and image-to-video, 1-15 seconds, 360p to 1080p, with optional audio. The lowest per-second video price at low resolution.
Genjutsu Object Swap
Genjutsu Object Swap API by Higgsfield. Replace an object, character or clothing in a source video using a reference image.