Variable output formats

Every completed MVNT job can expose preview, motion, and metadata outputs. Learn which endpoint to call for MP4, BVH, and GLB.

Every completed MVNT job can expose multiple outputs: a preview MP4 video, motion files for 3D pipelines, and JSON metadata. After GET /job/{job_id} returns status: "completed", call the output endpoint that matches the artifact you need.

Output endpoints

Use the job_id returned by POST /generate-motion in each output path:

Format	Endpoint	Typical filename
Preview MP4	GET /render-mp4/{job_id}	preview.mp4
BVH motion	GET /download-bvh/{job_id}	motion.bvh
GLB motion	GET /download-glb/{job_id}	motion.glb

All output endpoints require your API key and are authenticated the same way as every other MVNT API request. Downloading an output does not consume additional credits.

Formats

Preview MP4

The preview MP4 is a rendered video of the generated motion — a character performing the dance against a neutral background. It is the fastest way to see your generation result and is ready for immediate human review or display in a product UI.

Endpoint

GET /render-mp4/{job_id}

Download example

curl -L "https://api.mvnt.studio/render-mp4/{job_id}" \
  -H "Authorization: Bearer mvnt_live_xxxxxxxxxxxx" \
  --output preview.mp4

When to use preview MP4

• Display motion generation results in your product UI without any 3D rendering on your side
• QA and visual review before exporting to a motion file
• Motion-transfer workflows where the MP4 is the input to a downstream model
• ComfyUI preview nodes that accept video input
• Partner model cards, demos, and product screenshots

Use the -L flag with curl to follow redirects if the endpoint returns one.

BVH

BVH (Biovision Hierarchy) is a text-based skeletal animation format that encodes bone hierarchy and keyframe data. It is widely supported by 3D tools and game engines and is the most portable format for motion retargeting work.

Endpoint

GET /download-bvh/{job_id}

Download example

curl -L "https://api.mvnt.studio/download-bvh/{job_id}" \
  -H "Authorization: Bearer mvnt_live_xxxxxxxxxxxx" \
  --output motion.bvh

When to use BVH

• Blender: import directly via the BVH importer and retarget to any armature
• Retargeting pipelines that need raw bone data without an embedded mesh
• Motion analysis tools that parse keyframe sequences
• Game engine import workflows (Unity, Godot, and others) that prefer BVH for skeletal animation data

BVH is usually the most flexible starting point because the format is human-readable and well-supported across toolchains.

GLB

GLB is a binary glTF file that can include mesh, skeleton, materials, and animation in a single portable asset.

Endpoint

GET /download-glb/{job_id}

Download example

curl -L "https://api.mvnt.studio/download-glb/{job_id}" \
  -H "Authorization: Bearer mvnt_live_xxxxxxxxxxxx" \
  --output motion.glb

When to use GLB

• Web 3D viewers and browser-based preview tools
• Pipelines that prefer glTF-compatible assets
• Workflows that need a mesh-inclusive animated asset

Output path parameter

job_id · string · required

The job ID returned by POST /generate-motion. Replace {job_id} with that returned value.

Choosing a format

Format	Best for
Preview MP4	Product UI, QA, demos, ComfyUI
BVH	Blender, retargeting, game engines
GLB	Web 3D, glTF pipelines, mesh-inclusive previews