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

# Create generation

> Set style to a name from GET /styles (defaults to All when omitted).
Upload audio and start LDA generation. Use trim_start and trim_end (seconds) for the
segment to animate (e.g. 0–20). Credits are held on accept (3 credits per billable second,
capped at 60s). See Platform Pricing; insufficient wallet returns 402.




## OpenAPI

````yaml /openapi.json post /generations
openapi: 3.1.0
info:
  title: MVNT Dance API
  version: 1.0.0-compact
  description: >
    HTTP reference for audio-to-dance generation at https://api.mvnt.studio/v1.

    Flow: GET /styles → POST /generations → GET /generations/{id} → GET
    /generations/{id}/output (GLB or MP4).

    Authenticate with Authorization: Bearer and your MVNT API key.

    Billing: 3 credits per billable second of the trimmed segment (max 60s) —
    see Platform Pricing.
  contact:
    name: MVNT API Support
    email: api@mvnt.world
    url: https://mvntinc.mintlify.app/
  license:
    name: Proprietary
    url: https://mvnt.studio/terms-of-service
servers:
  - url: https://api.mvnt.studio/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Motion Generation
    description: List styles, create and poll a generation job (credit hold on create)
  - name: Outputs
    description: Download GLB or MP4 from the same generation id
paths:
  /generations:
    post:
      tags:
        - Motion Generation
      summary: Create generation
      description: >
        Set style to a name from GET /styles (defaults to All when omitted).

        Upload audio and start LDA generation. Use trim_start and trim_end
        (seconds) for the

        segment to animate (e.g. 0–20). Credits are held on accept (3 credits
        per billable second,

        capped at 60s). See Platform Pricing; insufficient wallet returns 402.
      operationId: createGeneration
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - audio
              properties:
                audio:
                  type: string
                  format: binary
                  description: WAV/MP3/OGG/FLAC (max size per server policy).
                file:
                  type: string
                  format: binary
                  description: Alias for audio (accepted by server).
                style:
                  type: string
                  default: All
                  description: Style name from GET /styles.
                trim_start:
                  type: number
                  default: 0
                  description: Segment start time in seconds on the uploaded file.
                trim_end:
                  type: number
                  default: 0
                  description: >-
                    Segment end in seconds; must be greater than trim_start for
                    a bounded clip.
                seed:
                  type: integer
                  default: -1
                guidance:
                  type: number
                  default: 2
                temperature:
                  type: number
                  default: 1
                mode:
                  type: string
                  default: standard
                  description: standard or fast.
      responses:
        '202':
          description: Job accepted
        '401':
          description: Invalid or missing API key
        '402':
          description: insufficient_credits
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Public API key (mvnt_live_... or mvnt_test_...)

````

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