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-genjutsuSign 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.
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.
Genjutsu pricing
Pricing varies by mode and resolution. Billable source-video seconds are rounded up after clipping to the first 30 seconds.
| Specification | Unit | Price |
|---|---|---|
| 480P Motion transfer source video | second | $0.318029 |
| 720P Motion transfer source video | second | $0.681061 |
| 1080P Motion transfer source video | second | $1.632147 |
| 480P Object swap source video | second | $0.318029 |
| 720P Object swap source video | second | $0.681061 |
| 1080P Object swap source video | second | $1.632147 |
| 480P Restyle source video | second | $0.318029 |
| 720P Restyle source video | second | $0.681061 |
| 1080P Restyle source video | second | $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.