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

# MiniMax H3 Max — Text To Video

> MiniMax H3 Max — flagship quality at 480P/768P native. Optimized for text to video via apisale.

## Overview

MiniMax H3 Max — flagship quality at 480P/768P native. Optimized for text to video via apisale.

<Info>
  **Docs** = API contract + Try it (snapshot). **[Explore](https://apisale.ai/explore)** = browser playground. **[Model page](https://apisale.ai/models/minimax/h3-max/text-to-video)** = product examples.
</Info>

## Endpoint

```http theme={null}
POST https://api.apisale.ai/v1/run/minimax/h3-max/text-to-video
```

|                |                                 |
| -------------- | ------------------------------- |
| **Model slug** | `minimax/h3-max/text-to-video`  |
| **Category**   | Text to Video (`text-to-video`) |
| **Lab**        | Minimax                         |
| **Mode**       | async                           |

## Pricing

**From \$0.035/sec**

apisale price is **30%** below the vendor's official list price.

| Tier | Unit   | Official price | apisale price |
| ---- | ------ | -------------- | ------------- |
| 480P | second | \$0.050        | \$0.035       |
| 768P | second | \$0.080        | \$0.056       |

<Info>
  **Official price** = vendor list price. **apisale price** = what you pay through apisale.
</Info>

## Request

```json theme={null}
{‌
  "input": {‌
    "prompt": "Close portrait of a violinist under a single warm spotlight, dust in the beam, slow push-in, concert-hall hush",
    "duration": 5,
    "resolution": "768P",
    "aspect_ratio": "16:9",
    "enable_safety_checker": true,
    "prompt_expansion_mode": "balanced"
  }
}
```

### Parameters

Fields marked \* are required. Use `Authorization: Key YOUR_API_KEY` for REST.

<ParamField body="input.seed" type="number">
  Optional random seed.
</ParamField>

<ParamField body="input.prompt" type="string" required>
  Text prompt for video generation.
</ParamField>

<ParamField body="input.duration" type="number">
  Duration in seconds (5-15). Default: `5` Range: 5 – 15
</ParamField>

<ParamField body="input.resolution" type="string">
  The native generation resolution of the video. Default: `768P` Values: `480P`, `768P`
</ParamField>

<ParamField body="input.aspect_ratio" type="string">
  Default: `16:9` Values: `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`
</ParamField>

<ParamField body="input.enable_safety_checker" type="boolean">
  Default: `true`
</ParamField>

<ParamField body="input.prompt_expansion_mode" type="string">
  balanced \~1s; quality up to \~30s on a richer prompt. Default: `balanced` Values: `balanced`, `quality`
</ParamField>

<ParamField body="webhook_url" type="string">
  Optional HTTPS webhook when the run reaches a terminal state.
</ParamField>

<ParamField body="sync" type="boolean">
  Block until completion (same Run response shape).
</ParamField>

<AccordionGroup>
  <Accordion title="Input schema">
    ```json expandable theme={null}
    {‌
      "params": {‌
        "seed": {‌
          "type": "int",
          "description": "Optional random seed."
        },
        "prompt": {‌
          "type": "string",
          "required": true,
          "description": "Text prompt for video generation."
        },
        "duration": {‌
          "max": 15,
          "min": 5,
          "type": "int",
          "default": 5,
          "description": "Duration in seconds (5-15)."
        },
        "resolution": {‌
          "type": "enum",
          "values": [
            "480P",
            "768P"
          ],
          "default": "768P",
          "description": "The native generation resolution of the video."
        },
        "aspect_ratio": {‌
          "type": "enum",
          "values": [
            "21:9",
            "16:9",
            "4:3",
            "1:1",
            "3:4",
            "9:16"
          ],
          "default": "16:9"
        },
        "enable_safety_checker": {‌
          "type": "bool",
          "default": true
        },
        "prompt_expansion_mode": {‌
          "type": "enum",
          "values": [
            "balanced",
            "quality"
          ],
          "default": "balanced",
          "description": "balanced ~1s; quality up to ~30s on a richer prompt."
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Submit response

Returns a **Run** with `run_id`. Poll with [GET /v1/runs/\{run\_id}](/model-apis/poll-runs) or use **Try it** above.

<ResponseField name="run_id" type="string" required>
  Unique run ID — save for polling and webhooks.
</ResponseField>

<ResponseField name="status" type="string" required>
  `queued` (async) or terminal state for sync runs.
</ResponseField>

<ResponseField name="output" type="object">
  Result when `status` is `succeeded` — see **Output schema** below.
</ResponseField>

### Example (async submit)

```json theme={null}
{
  "run_id": "run_550e8400-e29b-41d4-a716-446655440000",
  "endpoint": "minimax/h3-max/text-to-video",
  "model": "text-to-video",
  "capability": "video",
  "mode": "text-to-video",
  "status": "queued",
  "output": null,
  "error": null,
  "billing": null,
  "created_at": "2026-06-27T12:00:00.000Z",
  "started_at": null,
  "completed_at": null,
  "elapsed_ms": null
}
```

Full lifecycle: [Runs lifecycle](/model-apis/runs-lifecycle).

## Output

When `status` is `succeeded`, `output` follows this schema:

<AccordionGroup>
  <Accordion title="Output schema">
    ```json expandable theme={null}
    {‌
      "type": "object",
      "example": {‌
        "videos": [
          {‌
            "url": "https://example.com/out.mp4",
            "content_type": "video/mp4"
          }
        ]
      },
      "required": [
        "videos"
      ],
      "properties": {‌
        "videos": {‌
          "type": "array",
          "items": {‌
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {‌
              "url": {‌
                "type": "string"
              },
              "file_name": {‌
                "type": "string"
              },
              "content_type": {‌
                "type": "string"
              }
            }
          }
        }
      },
      "description": "Succeeded task output: single video URL."
    }
    ```
  </Accordion>
</AccordionGroup>

## Example

```bash theme={null}
curl -X POST "https://api.apisale.ai/v1/run/minimax/h3-max/text-to-video" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Close portrait of a violinist under a single warm spotlight, dust in the beam, slow push-in, concert-hall hush",
    "duration": 5,
    "sync_mode": false,
    "resolution": "768P",
    "aspect_ratio": "16:9",
    "enable_safety_checker": true,
    "prompt_expansion_mode": "balanced"
  }
}'
```

## Related

* [Runs lifecycle](/model-apis/runs-lifecycle)
* [Video API overview](/api/video)
* [Account API](/get-started/account-and-monitoring)


## OpenAPI

````yaml openapi-catalog.json POST /v1/run/minimax/h3-max/text-to-video
openapi: 3.0.3
info:
  title: apisale Model Catalog
  version: '2026-09-01T09:47:50.773Z'
  description: Per-model OpenAPI operations for Mintlify Try playground.
servers:
  - url: https://api.apisale.ai
security: []
paths:
  /v1/run/minimax/h3-max/text-to-video:
    post:
      tags:
        - Model catalog
        - video
        - Minimax
      summary: Create MiniMax H3 Max — Text To Video
      description: >-
        MiniMax H3 Max — flagship quality at 480P/768P native. Optimized for
        text to video via apisale.
      operationId: submit-minimax-h3-max-text-to-video
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                input:
                  type: object
                  properties:
                    seed:
                      description: Optional random seed.
                      type: number
                    prompt:
                      description: Text prompt for video generation.
                      type: string
                    duration:
                      description: Duration in seconds (5-15).
                      type: number
                      minimum: 5
                      maximum: 15
                      default: 5
                    resolution:
                      description: The native generation resolution of the video.
                      type: string
                      enum:
                        - 480P
                        - 768P
                      default: 768P
                    aspect_ratio:
                      type: string
                      enum:
                        - '21:9'
                        - '16:9'
                        - '4:3'
                        - '1:1'
                        - '3:4'
                        - '9:16'
                      default: '16:9'
                    enable_safety_checker:
                      type: boolean
                      default: true
                    prompt_expansion_mode:
                      description: balanced ~1s; quality up to ~30s on a richer prompt.
                      type: string
                      enum:
                        - balanced
                        - quality
                      default: balanced
                  required:
                    - prompt
                  example:
                    prompt: >-
                      Close portrait of a violinist under a single warm
                      spotlight, dust in the beam, slow push-in, concert-hall
                      hush
                    duration: 5
                    resolution: 768P
                    aspect_ratio: '16:9'
                    enable_safety_checker: true
                    prompt_expansion_mode: balanced
                webhook_url:
                  type: string
                  format: uri
                sync:
                  type: boolean
                  default: false
            example:
              input:
                prompt: >-
                  Close portrait of a violinist under a single warm spotlight,
                  dust in the beam, slow push-in, concert-hall hush
                duration: 5
                resolution: 768P
                aspect_ratio: '16:9'
                enable_safety_checker: true
                prompt_expansion_mode: balanced
      responses:
        '201':
          description: Run accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunObject'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    RunObject:
      type: object
      required:
        - run_id
        - endpoint
        - model
        - capability
        - mode
        - status
        - created_at
      properties:
        run_id:
          type: string
          description: Unique run identifier
        endpoint:
          type: string
          description: Model slug
        model:
          type: string
        capability:
          type: string
        mode:
          type: string
        status:
          type: string
          enum:
            - queued
            - processing
            - succeeded
            - failed
            - timeout
            - cancelled
        output:
          type: object
          nullable: true
        error:
          type: object
          nullable: true
          properties:
            type:
              type: string
              description: Machine-readable error code
            code:
              type: number
              description: HTTP status
            message:
              type: string
        billing:
          type: object
          nullable: true
          properties:
            amount:
              type: string
            currency:
              type: string
              enum:
                - usd
        created_at:
          type: string
          format: date-time
        started_at:
          type: string
          format: date-time
          nullable: true
        completed_at:
          type: string
          format: date-time
          nullable: true
        elapsed_ms:
          type: number
          nullable: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Key sk-... (native REST) or Bearer sk-... (vendor SDKs)

````