YepAPI
HiggsfieldVideo Generation/v1/media/queue

Genjutsu Object Swap API

Genjutsu Object Swap from $0.636 per second of source video — replace a character, product, or outfit in any clip.

Higgsfield's Genjutsu object swap model. Replaces an object, character, or outfit in a source video with the one in your reference image — from $0.636 per second of source video.

No credit card required. Takes 30 seconds.

Genjutsu Object Swap API pricing

Pay per request from your YepAPI balance — no subscription, no monthly minimum. Prices updated November 1, 2026.

BillingPrice
Rate (480p)$0.636/sec
Rate (720p)$1.362/sec
Rate (1080p)$3.264/sec
What it costsPer job
5-second clipfrom lowest resolution$3.18
10-second clipfrom lowest resolution$6.36
100 × 5-second clipsan ad-creative batch$318.00

2,400+

Developers

1.2M+

API calls served

100+

Endpoints

$0.01

Per call

Yep, that's it.

Try it live

Enter a prompt and generate a video with Genjutsu Object Swap.

POST/v1/media/queue

Drop image or click to upload

For image-to-video (first/last frame)

Response
Hit "Send Request" to see the response

Genjutsu Object Swap specs

ProviderHiggsfield
Model IDhiggsfield/genjutsu-object-swap
Endpoint/v1/media/queue
TypeVideo Generation
Resolutions480p, 720p, 1080p
Image inputYes

How to get a Genjutsu Object Swap API key

  1. 1

    Create a free account

    Sign up at yepapi.com with Google or email. It takes about 30 seconds and needs no card.

  2. 2

    Create an API key

    Open the dashboard, go to API Keys and create a key. Copy it — it starts with yep_sk_.

  3. 3

    Call Genjutsu Object Swap

    Send a request to /v1/media/queue with the x-api-key header and model "higgsfield/genjutsu-object-swap".

  4. 4

    Pay as you go

    Usage is billed per request from your balance. Top up any amount; there is no subscription.

Strengths

✓
Replace a character in video

Swap the person, product, or outfit in an existing clip while keeping its motion, framing, and timing.

✓
Reference-image driven

The replacement comes from the image you send in `imageData`; the clip comes from `options.referenceVideoUrl`.

✓
Three resolutions

$0.636/sec at 480p, $1.362/sec at 720p, and $3.264/sec at 1080p, per second of source video.

✓
Lower-cost Light tier

Genjutsu Light Object Swap does the same job from $0.20 per source second for clips up to 15 seconds.

Quick start

Copy this snippet and start making calls with Genjutsu Object Swap.

// Step 1: Submit job
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-object-swap",
    "prompt": "Replace the jacket the person is wearing with the jacket in the reference image",
    "options": {
      "resolution": "1080p",
      "referenceVideoUrl": "https://example.com/source.mp4"
    },
    "imageData": {
      "mimeType": "image/png",
      "base64": "BASE64_DATA"
    }
  }),
});
const { data } = await res.json();
const jobId = data.jobId;

// Step 2: Poll for result
const status = await fetch(`https://api.yepapi.com/v1/media/status/${jobId}`, {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status: "pending" | "processing" | "completed" | "failed"
// job.result: { text?, image?, audio?, video? }

Genjutsu Object Swap vs similar models

Every model below runs on the same API key — switch by changing the model ID.

ModelProviderPrice
Genjutsu Object SwapHiggsfieldfrom $0.636/sec (480p), $1.362/sec (720p), $3.264/sec (1080p)
Genjutsu Light Motion TransferHiggsfieldfrom $0.20/sec (480p), $0.40/sec (720p), $0.80/sec (1080p)
Genjutsu Light Object SwapHiggsfieldfrom $0.20/sec (480p), $0.40/sec (720p), $0.80/sec (1080p)
Genjutsu Motion TransferHiggsfieldfrom $0.636/sec (480p), $1.362/sec (720p), $3.264/sec (1080p)
Seedance 1.0 Pro FastByteDancefrom about $0.02/sec (480p), about $0.04/sec (720p), about $0.10/sec (1080p)
Grok Imagine Video 1.5 LitexAIfrom $0.04/sec (480p)
HeyGen VideoHeyGenfrom $0.04/sec (480p)
PixVerse V6PixVersefrom $0.044/sec (360p), $0.06/sec (540p), $0.078/sec (720p), $0.154/sec (1080p); with audio (default) $0.06–$0.196/sec

Why use Genjutsu Object Swap through YepAPI?

✓One API key for all models — no separate accounts
✓No monthly minimums — pay per call
✓Switch models with one line of code
✓Simple REST API — works from any language
✓Unified billing across all providers
✓No rate limits for most use cases

Genjutsu Object Swap API — replace a character or object in video with AI

Genjutsu Object Swap is the editing half of Higgsfield's Genjutsu family. Give it a source video and a reference image, and it replaces the object, character, or clothing in the clip with the one in your image while the original motion stays intact.

On YepAPI send `higgsfield/genjutsu-object-swap` to `/v1/media/queue` with `options.referenceVideoUrl` and `imageData`, and describe the swap in the prompt. Billed per second of source video: $0.636 at 480p, $1.362 at 720p, $3.264 at 1080p.

Start generating in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”

Marcus T.

SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”

Priya S.

Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”

Jake R.

Indie Hacker

Frequently asked questions

Higgsfield's Genjutsu object swap model. Replaces an object, character, or outfit in a source video with the one in your reference image — from $0.636 per second of source video.

Genjutsu Object Swap costs from $0.636/sec (480p), $1.362/sec (720p), $3.264/sec (1080p) through YepAPI, billed per request with no monthly fee. For example, a 5-second clip (from lowest resolution) costs about $3.18.

Sign up at yepapi.com (Google or email, about 30 seconds), open the dashboard and create an API key. The same key works for Genjutsu Object Swap and every other model — no separate Higgsfield account or waitlist.

New YepAPI accounts in most countries get free signup credit, enough to test Genjutsu Object Swap without a card. After that you pay per request at the rates above — there is no subscription.

Use "higgsfield/genjutsu-object-swap" as the model on /v1/media/queue.

Ready to use Genjutsu Object Swap?

$5 free credit on signup. No credit card required. Pay per call.

Explore more models