> ## Documentation Index
> Fetch the complete documentation index at: https://mvnt.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Variable output formats

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

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

## Output endpoints

Use the `id` returned by `POST /v1/generations` in each output path:

| Format | Endpoint | Typical filename |
| - | - | - |
| Preview MP4 | `GET /generations/{id}/output?format=mp4` | `preview.mp4` |
| GLB motion | `GET /generations/{id}/output?format=glb` | `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

> [tab] 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**
>
> ```text theme={null}
> GET /generations/{id}/output?format=mp4
> ```
>
> **Download example**
>
> ```bash theme={null}
> curl -L "https://api.mvnt.studio/v1/generations/{id}/output?format=mp4&preset=standard&camera_mode=tracking" \
>   -H "Authorization: Bearer $MVNT_API_KEY" \
>   --output preview.mp4
> ```
>
> **MP4 options**
>
> * `preset=standard` — 1920×1080 (16:9)
> * `preset=shorts` — 1080×1920 (9:16)
> * `camera_mode=tracking` | `dynamic` | `idol`
>
> **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
>
> > [!NOTE]
> >
> > Use the `-L` flag with curl to follow redirects if the endpoint returns one.

> [tab] GLB
>
> GLB is a binary glTF file that can include mesh, skeleton, materials, and animation in a single portable asset.
>
> **Endpoint**
>
> ```text theme={null}
> GET /generations/{id}/output?format=glb
> ```
>
> **Download example**
>
> ```bash theme={null}
> curl -L "https://api.mvnt.studio/v1/generations/{id}/output?format=glb" \
>   -H "Authorization: Bearer $MVNT_API_KEY" \
>   --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
> * Blender, Unity, Unreal, and custom retargeting pipelines

## Output path parameter

**id** `string` *required*

The generation id returned by `POST /v1/generations`. Replace `{id}` with that returned value.

## Choosing a format

| Format | Best for |
| - | - |
| Preview MP4 | Product UI, QA, demos, ComfyUI |
| GLB | Web 3D, glTF pipelines, DCC handoff, mesh-inclusive previews |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.