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
/v1/media/queueOverview
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.
| Property | Value |
|---|---|
| Model ID | higgsfield/genjutsu-light-object-swap |
| 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 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 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-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 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-object-swap | — |
prompt | string | Yes | Short instruction for the swap | — |
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 (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
| 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 Object Swap via our AI provider.