Genjutsu 1.0 Object Swap API

Replace objects in a source video using reference images

480p
NanoAPI $0.117 / second
Official$0.15424% less
720p
NanoAPI $0.273 / second
Official$0.344621% less
1080p
NanoAPI $0.78 / second
Official$0.83467% less

Compare prices

Compare public channel prices for the same output specification

Compare other models
Output specificationProvidersPublished provider priceTypical timeTry it
480p
HiggsfieldOfficial
$0.154 / second
Reference price only; not available through Yir
NanoAPI
$0.117 / second24% less
Typical time 5.6 min
5.6 minTry it
720p
HiggsfieldOfficial
$0.3446 / second
Reference price only; not available through Yir
NanoAPI
$0.2730 / second21% less
Try it
1080p
HiggsfieldOfficial
$0.8346 / second
Reference price only; not available through Yir
NanoAPI
$0.7800 / second7% less
Try it
Pricing notes

Billed by the channel that actually runs the job. Failover may switch channels, which can change cost and time.

Use the API

Hand the code to a coding agent, generate right in the chat with MCP or the Skill, or integrate yourself with the SDK or the OpenAI-compatible API.

Let a coding agent integrate it

Copy the integration prompt, or open it directly in Codex or Claude. The agent reads this page and the model contract, then writes submit, wait and result handling into your project.

Add the Yir MCP server

Connect it to ChatGPT, Claude or Cursor, then mention @Yir and ask for Genjutsu 1.0 Object Swap by name. It quotes first and only generates after you confirm.

https://gateway.yir.ai/mcp
Setup steps for each client

One command for Claude Code

Create an API key in the console, set it as YIR_API_KEY, then run:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

Install the Yir Skill

Set YIR_API_KEY where your agent runs, add the Skill to Claude Code, Codex or another coding agent, then say “use Genjutsu 1.0 Object Swap on Yir to make…”.

npx skills add yir-ai/skills
About the Yir Skill

Install the official SDK with your package manager, or copy the code snippet below to get started

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. Submit a video generation job
const job = await client.submitVideo({
model: "higgsfield/genjutsu-1.0-object-swap",
input: {
type: "reference",
prompt: "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell",
references: [],
},
parameters: {
duration: 5,
resolution: "720p",
aspect_ratio: "auto",
generate_audio: false,
n: 1,
},
});
 
// 2. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

Projects already on the OpenAI protocol, or gateways such as new-api, only need a new Base URL and key. OpenAI compatibility guide

OpenAI SDK base_url
https://gateway.yir.ai/openai/v1
new-api channel Base URL
https://gateway.yir.ai/openai
Key
Yir API key
Model ID
higgsfield/genjutsu-1.0-object-swap
curl https://gateway.yir.ai/openai/v1/videos \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "higgsfield/genjutsu-1.0-object-swap",
    "prompt": "A sea turtle swims slowly over a coral reef. The camera tracks smoothly from the side as sunlight filters through clear water, casting moving patterns across its shell",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "seconds": "5"
  }'

Parameter overview

Common parameters; limits depend on the current model and selected channel

API docs
Resolution
resolution
  • 480p
  • 720p
  • 1080p

Output resolution tier. Higher resolutions offer sharper pixel fidelity and scale pricing accordingly

Aspect ratio
aspect_ratio
  • auto

Geometric aspect ratio. Choose according to target medium (portrait, banner, or square)

Input mode
input_mode
  • Reference input

Reference limits and formats depend on the model and selected channel

Duration
duration
  • 4–30 seconds

Video output duration tier, billed per second or stepped tier

References
references
  • reference_image ≤ 10
  • reference_video ≤ 1

Reference limits across input modes depend on the selected channel. Counts in the price table are examples, not input limits or free allowances.

Frequently asked questions

Start building with Genjutsu 1.0 Object Swap

Compare the same spec across providers and call multiple providers from one wallet.