Skip to main content
Motion Transfer uses an existing video for motion and reference images for the target subject. This guide walks through preparation, submission and download.

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, 720p or 1080p. Motion Transfer does not accept duration, aspect ratio, FPS or audio controls.
Use curl and Python 3. Set GENGEN_API_KEY in your local environment and keep it out of browser code and source control.

Submit the transformation

Save this as request.json, replacing both placeholder URLs with accessible media:
request.json
The task is billable. The rate depends on mode and resolution; source-video seconds are rounded up after clipping to 30 seconds. Submit once:
Continue only after a successful HTTP response containing 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 as poll_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
Download successful outputs promptly because output URLs can expire. If the download fails, rerun the polling script with the saved ID; it will retrieve the task again without submitting a new generation.

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 the mode field is not enough to adapt a Motion Transfer request. See Genjutsu workflows and pricing and the full API reference.