---
title: "Generate"
method: POST
path: "/v1/generate"
tags: ["generate"]
---

# Generate

`POST /v1/generate`

## Request

- Base URL: `https://api.mocapless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mocapless.com/v1/generate`
- Auth: none declared

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- GenerateRequest
  - `prompt` string
  - `assetId` string, nullable
  - `fps` integer
  - `loop` boolean, nullable
  - `formats` string[]
  - `seed` integer
  - `useLlm` boolean
  - `engine` string
  - `samples` integer
  - `beats` BeatModel[], nullable
    - `text` string, required
    - `seconds` number, required
  - `script` ScriptModel
    - `segments` SegmentModel[], required
      - `primitive` string, required
      - `seconds` number
      - `speed` number
      - `amplitude` number
      - `style` string
      - `repeats` integer
      - `mirror` boolean
      - `turn` number
      - `params` object
    - `fps` integer
    - `loop` boolean
    - `source` string
    - `confidence` number
    - `notes` string[]
    - `prompt` string
    - `duration` number
    - `beats` object[]
    - `family` string

## Response `202`

Successful Response

- JobResponse
  - `id` string, required
  - `status` string, required
  - `stage` string, required
  - `progress` number, required
  - `prompt` string, required
  - `error` string, nullable, required
  - `creditsCost` integer, required
  - `creditsRefunded` boolean, required
  - `frames` integer, required
  - `durationSeconds` number, required
  - `assetId` string, nullable, required
  - `createdAt` string, date-time, required
  - `finishedAt` string, date-time, nullable, required
  - `script` ScriptModel
    - `segments` SegmentModel[], required
      - `primitive` string, required
      - `seconds` number
      - `speed` number
      - `amplitude` number
      - `style` string
      - `repeats` integer
      - `mirror` boolean
      - `turn` number
      - `params` object
    - `fps` integer
    - `loop` boolean
    - `source` string
    - `confidence` number
    - `notes` string[]
    - `prompt` string
    - `duration` number
    - `beats` object[]
    - `family` string
  - `outputs` JobOutput[]
    - `kind` string, required
    - `url` string, required
    - `locked` boolean
  - `rating` integer, nullable
  - `ratingStars` integer, nullable
  - `engine` string
  - `fallbackFrom` string, nullable
  - `variant` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mocapless/apis/mocapless-api.md) · [All operations](https://skmtc.dev/mocapless/apis/mocapless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mocapless/apis/mocapless-api/revisions/37b479a6e615?raw)