Genjutsu Light Motion Transfer
Genjutsu Light Motion Transfer API by Higgsfield. Lower-cost AI motion transfer: apply a source video's motion (first 15 s) to your reference image.
Pricing, live playground and model overview: Genjutsu Light Motion Transfer API on YepAPI
/v1/media/queueOverview
Higgsfield's Genjutsu Light Motion Transfer — the lower-cost version of Genjutsu Motion Transfer. It uses the first 15 seconds of your source video and keeps its audio. Async operation — submit a job, poll for completion.
| Property | Value |
|---|---|
| Model ID | higgsfield/genjutsu-light-motion-transfer |
| Alias | genjutsu-light |
| Provider | Higgsfield |
| Inputs | source video |
| Resolutions | 480p, 720p, 1080p |
| Source Video | Public MP4 or MOV URL, at least 4 seconds (first 15 seconds used) |
| Billing | Per job — priced when queued, charged only on success |
| Pricing | from $0.20/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. Only the first 15 seconds of the source are used, and its audio is kept.
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-light-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-light-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-light-motion-transfer or alias genjutsu-light | — |
prompt | string | Yes | Short instruction for the motion transfer | — |
options.resolution | string | No | 480p, 720p, 1080p | 720p |
options.referenceVideoUrl | string | Yes | Public MP4 or MOV URL of the source video (first 15 seconds used) | — |
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); first 15 seconds used - Character or scene from a reference image (
imageData) - Keeps the source video's audio
- 480p, 720p or 1080p
Pricing
| Resolution | Cost per second of source video |
|---|---|
| 480p | $0.20 |
| 720p | $0.40 |
| 1080p | $0.80 |
Billed on the source video's length, rounded up to whole seconds, up to the first 15 seconds. Example: 10-second source at 720p = 10 × $0.40 = $4.00; a 40-second source is billed as 15 seconds = $6.00 at 720p (the rate covers the whole job). Each job is priced when it's queued and charged only if it succeeds — failed or moderated jobs are free.
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 Light Motion Transfer via our AI provider.
Genjutsu Object Swap
Genjutsu Object Swap API by Higgsfield. Replace an object, character or clothing in a source video using a reference image.
Genjutsu Light Object Swap
Genjutsu Light Object Swap API by Higgsfield. Lower-cost object, character or clothing replacement in the first 15 seconds of a source video.