Higgsfield Genjutsu API: Motion Transfer, Inputs, Pricing and Limits
Genjutsu is Higgsfield’s video motion-transfer API: start with a source video and reference images to change its appearance while retaining its motion. It fits developers reworking existing footage, not a blank text-to-video workflow. Confirm the 4-second minimum, chosen resolution, rights and applicable price before submitting a job.
AI Tool Finder Editorial Team · Official documentation reviewed October 13, 2026
No API calls, paid generation or hands-on product tests were performed. Public documentation and independent evaluation records do not prove our account has access.
One provider, different buying tasks
The official Higgsfield API catalog identifies Genjutsu as a motion-transfer workflow that changes characters, locations and styles while keeping motion. This is not a separate company. Our Higgsfield MCP profile covers connecting an agent to a Higgsfield account; AI Influencer covers character workflows; Ads Studio covers static advertising concepts.
A source performance gives motion transfer an existing sequence to follow. Text-to-video instead asks a generator to invent the scene and movement from a brief. If your original camera move is wrong, preserving it may be a disadvantage. “Keeping motion” is the vendor's capability description, not a measured guarantee that every pose, camera movement or frame stays identical.
Inputs, outputs and the contract to check
| Item | Published contract | Practical consequence |
|---|---|---|
| Source video | video_url; at least 4 seconds | Prepare a usable source clip before requesting a transformation. |
| Long clips | Over 30 seconds trimmed to 30; output follows prepared source duration | Do not expect a full-length edit from one request. |
| References | image_urls; 1–8 images | Use authorized, clear references; preservation of logos and identity remains untested. |
| Prompt | Optional; default empty string; maximum 10,000 characters | Describe the intended change without assuming the prompt replaces required media. |
| Resolution | 480p, 720p or 1080p; default 720p | Set it deliberately: the default does not use the cheapest rate. |
| Result | Asynchronous completion returns a file in video | Submission is not completion; retrieve and inspect the output. |
Source: official motion-transfer API reference. The overview's related-model card displays “1–30s”; the specific input instructions require at least four seconds. Use the specific contract and confirm any discrepancy with the provider.
The motion-transfer page supports appearance changes to characters, locations and style. A separate Object Swap variant also appears in the catalog. Do not infer that this endpoint guarantees arbitrary product replacement or exact label/text preservation. Test those acceptance criteria only with authorized assets and a separately approved budget.
Price is based on input seconds, not one finished video
The official overview gives these reference rates before applicable customer discounts. Input duration is rounded up to whole seconds.
| Resolution | Reference rate | Promotion evidence |
|---|---|---|
| 480p | $0.318 / input second | Catalog shows 50% off, from $0.159 / second |
| 720p | $0.681 / input second | Confirm your account's applicable discount and rounding |
| 1080p | $1.632 / input second | Confirm your account's applicable discount and rounding |
The higher-resolution reference rates above are explicitly listed; they are not extrapolated from 480p. We did not verify an official October 31 promotion end date. The observed discount is dated evidence, not a promised duration or account entitlement.
Illustrative calculation: a 4.2-second eligible input rounds to five seconds. At the observed discounted 480p rate, its generation subtotal would be 5 × $0.159 = $0.795; at the reference rate, 5 × $0.318 = $1.59. This is arithmetic, not a paid receipt. Confirm the duration used for billing when a clip is trimmed, account discounts, any extras and retry charges. Do not confuse website subscription credits or “Unlimited” promotions with this API contract.
Submit, wait, retrieve—then accept or reject the result
The current official code sample identifies the model as higgsfield/genjutsu/motion-transfer/v1.0. Check that exact spelling against the linked reference when integrating; do not invent a similarly spelled path or borrow another model's parameter set.
- Prepare the authorized video and image URLs. Confirm duration and resolution, then keep credentials on the server.
- Submit the documented input. The official TypeScript client uses
higgsfield.subscribefrom@higgsfield/client/v2withvideo_url,image_urls, optionalpromptandresolution. - Wait for the job. The documented
withPolling: trueoption waits for a terminal result. For explicit lifecycle handling, the reference shows Python status, result and cancellation methods keyed by the existing request ID. - Inspect the returned video. Verify motion, identity, product details, duration, resolution and the actual file before accepting the deliverable.
On a timeout, preserve the request ID and check the existing job before resubmitting. A client timeout alone does not prove generation failed; blind retries can create duplicate jobs and cost. Failure/refund treatment was not independently established in this review. Use the official quick start and model-specific reference for the current SDK and credential instructions. This page has not executed them.
Where it fits—and what still needs approval
Consider this API when an approved source clip already has the motion and composition you need, and your application can wait for an asynchronous result. Prefer a conventional editor when exact frame control is essential; compare general video generators when you need to invent motion from text or a still image.
Confirm permission for the source footage, reference images, depicted people, trademarks and intended distribution. A generated file does not establish likeness permission, ownership or commercial-use rights. Review current provider terms for your use case, and inspect edits that could misrepresent a real person or product.
Open the official Genjutsu overview
No video was generated, no third-party media was uploaded and no account balance was purchased. Actual output quality, camera consistency, queue time, failure billing and user-specific discounts remain untested.