> ## 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 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

<Tabs>
  <Tab title="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 /render-mp4/{job_id}
    ```

    **Download example**

    ```bash theme={null}
    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

    <Note>
      Use the `-L` flag with curl to follow redirects if the endpoint returns one.
    </Note>
  </Tab>

  <Tab title="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**

    ```text theme={null}
    GET /download-bvh/{job_id}
    ```

    **Download example**

    ```bash theme={null}
    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

    <Tip>
      BVH is usually the most flexible starting point because the format is human-readable and well-supported across toolchains.
    </Tip>
  </Tab>

  <Tab title="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 /download-glb/{job_id}
    ```

    **Download example**

    ```bash theme={null}
    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
  </Tab>
</Tabs>

## Output path parameter

<ParamField path="job_id" type="string" required>
  The job ID returned by `POST /generate-motion`. Replace `{job_id}` with that returned value.
</ParamField>

## 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 |