Higgsfield Genjutsu Guide: Now Available via API

Genjutsu is Higgsfield’s video editing model. It keeps a real video’s motion while changing who or what appears in it, where it takes place, or how it looks.

Motion transfer

Drop a new character into a video while keeping the original movement

Object swap

Replace one object in a video with another

Restyle

Redraw an entire video in one of 20+ animation styles, or in your own style

You shoot the motion. Genjutsu changes the world around it.

August 31, 2026

Genjutsu launched with two features: motion transfer and object swap

September 30, 2026

Restyle arrived, along with Higgsfield API access for apps and workflows

Higgsfield web app

For creators who prefer to edit by hand

MCP

Use it from any AI assistant that supports MCP

Higgsfield API

Build it into your own apps and automated pipelines

• Set up a Higgsfield API account and add a payment balance
• Create an API key in the Higgsfield console
• Send requests to the higgsfield/genjutsu/motion-transfer/v1.0 endpoint
• Receive a request ID, since jobs run in the background
• Poll the status, or get a webhook when the job finishes
• Download the finished result

Official SDKs are available, or you can use plain HTTP requests.

Source video

At least 4 seconds. Anything over 30 seconds is trimmed to 30.

Image references

1 to 8 images for motion transfer through the API

Prompt

Optional, with a limit of 10,000 characters

Output length

Matches the prepared source video

Restyle in the web app accepts up to 30 reference images and outputs at 480p, 720p, or 1080p. Check the API reference for the values each endpoint accepts.

As of October 14, 2026, Higgsfield’s API pricing page lists Genjutsu from $0.318 per second at list price, and from $0.159 per second with the current 50% discount. The API is pay-per-use and billed separately from higgsfield.ai plans. Check the pricing page before you set a budget.

• Shoot a steady, well-lit source video
• Keep the subject clearly in view
• Supply clear reference images from several angles
• Test with short clips first
• State in the prompt what must stay the same

• Turn one ad into many versions with different characters
• Restyle live-action footage as animation
• Swap products inside demo videos
• Keep characters consistent across series content
• Add creative video features to your own app

• Store your API key on your server, never in front-end code
• Use webhooks rather than constant polling
• Set spending limits and monitor usage
• Handle failed and trimmed videos gracefully in your app
• Give users clear terms on what they may upload

• Use only videos you own or have permission to edit
• Get consent from everyone who appears in the video
• Never make a real person appear to do something they did not do
• Respect copyrighted characters and brands
• Label AI-edited video wherever platforms require it