Prepare your inputs
- Create an API key, fund your wallet and review Genjutsu pricing.
- Host a source video of at least four seconds at a URL readable without extra headers. Only the first 30 seconds are processed.
- Host 1–8 reference images of the target subject. Use material you have permission to process.
- Choose
480p,720por1080p. Motion Transfer does not accept duration, aspect ratio, FPS or audio controls.
GENGEN_API_KEY in your local environment and keep it out of browser code and source control.
Submit the transformation
Save this asrequest.json, replacing both placeholder URLs with accessible media:
request.json
id. Preserve task.json to resume an existing task. If submission times out, check Dashboard task logs or contact support before creating another task.
Poll and download
Save this aspoll_video.py and run python3 poll_video.py. It resumes the ID in task.json, retries only temporary GET failures, and never creates another generation task. The 30-minute polling limit is a client timeout, not a provider completion guarantee; you can resume polling later with the same file.
poll_video.py
Handle failures before retrying
For assistance, include the task ID, model ID and error code, without your API key. See provider troubleshooting and support.
Choose another transformation
Use the mode-specific schemas for Object Swap and Restyle. Restyle uses the live style directory. Replacing only themode field is not enough to adapt a Motion Transfer request.
See Genjutsu workflows and pricing and the full API reference.