Developer profile · Source-based review

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

Specific API reference, checked October 13, 2026
ItemPublished contractPractical consequence
Source videovideo_url; at least 4 secondsPrepare a usable source clip before requesting a transformation.
Long clipsOver 30 seconds trimmed to 30; output follows prepared source durationDo not expect a full-length edit from one request.
Referencesimage_urls; 1–8 imagesUse authorized, clear references; preservation of logos and identity remains untested.
PromptOptional; default empty string; maximum 10,000 charactersDescribe the intended change without assuming the prompt replaces required media.
Resolution480p, 720p or 1080p; default 720pSet it deliberately: the default does not use the cheapest rate.
ResultAsynchronous completion returns a file in videoSubmission 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.

USD per input second · observed October 13
ResolutionReference ratePromotion evidence
480p$0.318 / input secondCatalog shows 50% off, from $0.159 / second
720p$0.681 / input secondConfirm your account's applicable discount and rounding
1080p$1.632 / input secondConfirm 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.

  1. Prepare the authorized video and image URLs. Confirm duration and resolution, then keep credentials on the server.
  2. Submit the documented input. The official TypeScript client uses higgsfield.subscribe from @higgsfield/client/v2 with video_url, image_urls, optional prompt and resolution.
  3. Wait for the job. The documented withPolling: true option waits for a terminal result. For explicit lifecycle handling, the reference shows Python status, result and cancellation methods keyed by the existing request ID.
  4. 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.