YepAPI
AI Models

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.

Pricing, live playground and model overview: Genjutsu Light Object Swap API on YepAPI

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

Overview

Higgsfield's Genjutsu Light Object Swap — the lower-cost version of Genjutsu Object Swap. 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-object-swap
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 object, character or clothing to swap in) 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-object-swap',
    prompt: 'Replace the jacket in the video with the jacket in the reference image',
    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-object-swap", "prompt": "Replace the jacket in the video with the jacket in the reference image", "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-object-swap—
promptstringYesShort instruction for the swap—
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 (object, character or clothing to swap in)—

Options are validated when you submit: an unsupported duration, resolution or value returns 400 naming the allowed values.

Features

  • Source video via options.referenceVideoUrl; first 15 seconds used
  • Replacement object, character or clothing from 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 Object Swap via our AI provider.

On this page