1
Get an API key
All MVNT API requests require a bearer token. Create one in MVNT Studio Platform:
- Sign in.
- Open the API Keys tab.
- Click Create Key and choose Production or Sandbox/Test.
- Copy the full key immediately — it is shown only once.
mvnt_live_. Test keys have the prefix mvnt_test_. Store your key in an environment variable so it stays out of your code:2
List dance styles
Call
GET /styles to list available style names. Use one of the returned name values as the style field when you create a generation.3
Create a generation
Submit a The API responds immediately with a generation object. The Save the
POST request to /generations with your audio file and generation parameters. The API accepts multipart form data.status field starts as queued — the motion model has not started yet.id value — you will use it to poll status and download outputs.4
Poll for completion
Send a The
GET request to /generations/{id} to check the status of your job. Repeat until the status reaches a terminal state.status field moves through the following lifecycle:5
Download the preview MP4
Once the status is The
completed, download the preview MP4. This is the default human-readable output and is suitable for product UI, QA reviews, and motion-transfer workflows.-L flag tells curl to follow redirects if the endpoint returns one.Optional query parameters:
preset=standard (1920×1080) or preset=shorts (1080×1920), and camera_mode=tracking, dynamic, or idol. MP4 rendering can take a while — use a generous client timeout.6
Download the GLB motion file
For 3D pipelines — Blender, Unity, Unreal, or custom retargeting — download the GLB file.
Output entitlements depend on your MVNT Studio plan. Check your plan’s output access in MVNT Studio Platform.
Next steps
You have completed a full generation cycle. From here you can:- Open the API Reference tab for every parameter accepted by
POST /v1/generations - Learn about output formats and when to use MP4 vs GLB
- Set up a ComfyUI integration to run MVNT inside a visual node workflow
