Skip to main content
MarkdownLLMs.txt

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​

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​

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​

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​

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.

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.

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"
  }'