# MiniMax H3 / H3 Max Examples

> Copyable MiniMax native API requests for H3 and H3 Max video generation, media references, Context, and 2K regeneration.

Canonical URL: https://docs.uniall.ai/models/video/minimax-h3/examples
Locale: en

# MiniMax H3 / H3 Max Request Examples

Replace `$UNIAI_API_KEY` and media URLs with your own values. Send one request at a time.

## Text to video

```bash
curl -X POST "https://api.uniall.ai/v2/video_generation" \
  -H "Authorization: Bearer $UNIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "A paper boat crosses a quiet pond in warm morning light."
      }
    ],
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9"
  }'
```

## First and last frame

```bash
curl -X POST "https://api.uniall.ai/v2/video_generation" \
  -H "Authorization: Bearer $UNIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "The camera moves from the first frame to the last."
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://YOUR_PUBLIC_URL/first.png"
        },
        "role": "first_frame"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://YOUR_PUBLIC_URL/last.png"
        },
        "role": "last_frame"
      }
    ],
    "duration": 5,
    "resolution": "768P"
  }'
```

## Image, video, and audio references

```bash
curl -X POST "https://api.uniall.ai/v2/video_generation" \
  -H "Authorization: Bearer $UNIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "A person speaks while walking through the city."
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://YOUR_PUBLIC_URL/person.png"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://YOUR_PUBLIC_URL/walking.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://YOUR_PUBLIC_URL/voice.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "duration": 5,
    "resolution": "768P",
    "ratio": "adaptive"
  }'
```

## H3 Max

```bash
curl -X POST "https://api.uniall.ai/v2/video_generation" \
  -H "Authorization: Bearer $UNIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-Max",
    "content": [
      {
        "type": "text",
        "text": "A paper boat crosses a quiet pond in warm morning light."
      }
    ],
    "duration": 5,
    "resolution": "768P",
    "ratio": "16:9",
    "extra": {
      "prompt_expansion_mode": "balanced"
    }
  }'
```

## Context

Returns a processed prompt; it does not create a video. Omit `resolution`.

```bash
curl -X POST "https://api.uniall.ai/v2/h3_context_ir" \
  -H "Authorization: Bearer $UNIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "A paper boat crosses a quiet pond in warm morning light."
      }
    ],
    "duration": 5,
    "ratio": "16:9"
  }'
```

## Regenerate at 2K

Use your own completed H3 768P task, created within the last seven days.

```bash
curl -X POST "https://api.uniall.ai/v2/video_regeneration" \
  -H "Authorization: Bearer $UNIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "source_task_id": "task_YOUR_COMPLETED_H3_768P",
    "resolution": "2K"
  }'
```