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

# Text to Video

> This endpoint generates a video from a text prompt using the MiniMax H3 model.

> [!WARNING]
>
> Make sure you add your [s3 details](https://docs.modelslab.com/enterprise-api/general/update-s3-details.mdx) for the `minimax_h3` server, so you can receive the video generated in your bucket.
> Videos generated without s3 details being added will be deleted after **24 hours**.

## Request

Make a `POST` request to below endpoint and pass the required parameters as a request body.

```curl curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
--request POST 'https://modelslab.com/api/v1/enterprise/minimax_h3/text2video' \
```

## Body

```json json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "key": "enterprise_api_key",
  "prompt": "a lone astronaut walking across a red dune at sunset, cinematic wide shot",
  "width": 1024,
  "height": 576,
  "duration": 5,
  "num_frames": 120,
  "num_inference_steps": 30,
  "seed": null,
  "instant_response": false,
  "temp": false,
  "webhook": null,
  "track_id": null
}
```

## Body Attributes

**key** `string` *required*

Your API Key used for request authorization.

**prompt** `string` *required*

Text prompt with a description of the things you want in the video to be generated. The prompt is the only thing this endpoint has to work from, so it is required.

**width** `number`

Width of the generated frame. Must be a multiple of **32** and at most **1536**. Must be sent together with `height`.

**height** `number`

Height of the generated frame. Must be a multiple of **32** and at most **1536**. Must be sent together with `width`.

**duration** `number`

Length of the generated video in seconds. Minimum is `5`, maximum is `15`.

**num\_frames** `number`

The number of frames in the generated video. Minimum is `120`, maximum is `345`.

**num\_inference\_steps** `number`

Number of denoising steps. Minimum is `1`, maximum is `50`.

**seed** `number`

Seed is used to reproduce results. The same seed will give you the same video again. Pass *null* for a random number.

**instant\_response** `boolean` (default: false)

Queue response instantly before processing finishes instead of waiting a minimum amount of time. **default**: `false`, **options**: `true` or `false`.

**temp** `boolean` (default: false)

If true, stores the video in temporary storage which is cleaned every 24 hours. **default**: `false`, **options**: `true` or `false`.

**webhook** `string`

Set a URL to get a POST API call once the video generation is complete.

**track\_id** `string`

This ID is returned in the response to the webhook API call. This will be used to identify the webhook request.


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