YepAPI
AI Models

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

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

Overview

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.

PropertyValue
Model IDhiggsfield/genjutsu-motion-transfer
Aliasgenjutsu, motion-transfer
ProviderHiggsfield
Inputssource video
Resolutions720p, 480p, 1080p
Source VideoPublic MP4 or MOV URL, at least 4 seconds
BillingPer job — priced when queued, charged only on success
Pricingfrom $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 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-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-motion-transfer or aliases genjutsu, motion-transfer—
promptstringYesShort instruction for the motion transfer—
options.resolutionstringNo720p, 480p, 1080p720p
options.referenceVideoUrlstringYesPublic MP4 or MOV URL of the source video—
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)
  • Character or scene from a reference image (imageData)
  • 480p, 720p or 1080p
  • Billed per second of source video

Pricing

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

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 Motion Transfer via our AI provider.

On this page