YepAPI
AI Models

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

POST/v1/media/queue
from $0.20/source second

Overview

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.

PropertyValue
Model IDhiggsfield/genjutsu-light-motion-transfer
Aliasgenjutsu-light
ProviderHiggsfield
Inputssource video
Resolutions480p, 720p, 1080p
Source VideoPublic MP4 or MOV URL, at least 4 seconds (first 15 seconds used)
BillingPer job — priced when queued, charged only on success
Pricingfrom $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 results
curl -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 completed
curl https://api.yepapi.com/v1/media/status/JOB_ID \
  -H "x-api-key: YOUR_API_KEY"

Request Body

ParameterTypeRequiredDescriptionDefault
modelstringYeshiggsfield/genjutsu-light-motion-transfer or alias genjutsu-light—
promptstringYesShort instruction for the motion transfer—
options.resolutionstringNo480p, 720p, 1080p720p
options.referenceVideoUrlstringYesPublic MP4 or MOV URL of the source video (first 15 seconds used)—
imageData.mimeTypestringYesMIME type of input image (image/png, image/jpeg, image/webp)—
imageData.base64stringYesBase64-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

ResolutionCost 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.

Info

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.

Warning

The source video must be reachable at a public URL (MP4 or MOV). Pricing follows the source video's length, not the output.

Under the Hood

Powered by Higgsfield's Genjutsu Light Motion Transfer via our AI provider.

On this page