GENGEN

GENGEN video API

Genjutsu API

Transform an existing video with Motion Transfer, Object Swap or Restyle. Start with a source clip and choose the workflow that matches your edit.

higgsfield-genjutsu

Sign in to create an API key or submit a generation. A funded wallet is required for paid requests.

When to use Genjutsu

Motion Transfer

Transfer motion from a source video to the subject in 1–8 reference images.

Object Swap

Replace a subject or object using reference imagery. Consult the mode-specific requirements before preparing your request.

Restyle

Apply an available style to a source video. Read the live style directory instead of keeping a hardcoded style list.

Inputs and limits

  • Source video must be at least 4 seconds. Only the first 30 seconds are processed.
  • Motion Transfer supports 480p, 720p and 1080p. Omit duration, aspect ratio, FPS and audio controls.
  • Use accessible source-video and reference-image URLs. A text-only request is not a Motion Transfer workflow.
Read the full parameter reference →

Start with one request

Send this JSON with your bearer API key to POST /v1/contents/generations/tasks.

Replace the example URLs with your own accessible media before submitting.

{
  "model": "higgsfield-genjutsu",
  "mode": "motion_transfer",
  "prompt": "",
  "assets": {
    "sourceVideo": "https://example.com/source.mp4",
    "referenceImages": [
      "https://example.com/reference.png"
    ]
  },
  "controls": {
    "resolution": "720p"
  }
}

Save the returned id, then poll the task until it completes. Download the video from outputs.videos.

Submission, polling and download example →

Genjutsu pricing

Pricing varies by mode and resolution. Billable source-video seconds are rounded up after clipping to the first 30 seconds.

Public customer rates in USD
SpecificationUnitPrice
480P Motion transfer source videosecond$0.318029
720P Motion transfer source videosecond$0.681061
1080P Motion transfer source videosecond$1.632147
480P Object swap source videosecond$0.318029
720P Object swap source videosecond$0.681061
1080P Object swap source videosecond$1.632147
480P Restyle source videosecond$0.318029
720P Restyle source videosecond$0.681061
1080P Restyle source videosecond$1.632147

Public rates can take up to 15 minutes to refresh. Account-specific prices may differ; your request uses the price applied at submission.

View all current prices →

Before your first production request

Start with a short task, save its ID, and verify polling and download handling. Review content errors before retrying; changing models does not guarantee an input will be accepted.