Minimax H3 Image To Video Spicy API Documentation

Minimax H3 Image To Video Spicy API Documentation

Playground

MiniMax H3 Open Weights Spicy Image to Video is a fast AI image-to-video generation model that creates high-quality cinematic clips from images, optimized for scalable content generation with smooth, expressive animations, stable aesthetics, and native stereo audio. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

MiniMax H3 Image-to-Video Spicy Open Weights animates a start image into a video with prompt-guided motion. The output canvas follows the input image’s aspect ratio, and you can optionally provide a last_image to guide the ending frame.

Why Choose This?

• Image-to-video generation
  Animate a start image into a short video.

• Optional prompt control
  Add a prompt to describe the scene, action, camera movement, and mood.

• Start-and-end-frame guidance
  Use image as the first frame and optionally provide last_image to guide the final frame.

• Native canvas option
  Use 768p for the model’s native canvas, 480p for faster, lower-cost generation, 540p for a mid tier at 1.5x the 480p price, or 1080p for full-HD output at 2x the 768p price.

• Flexible duration
  Choose an output duration from 3 to 15 seconds.

• Seed support
  Set a seed for more reproducible generation, or use a negative value for random generation.

Parameters

How to Use

1. Upload a start image — Provide the image that should define the first frame and canvas aspect ratio.
2. Write a prompt optional — Describe the action, motion, camera movement, mood, and scene direction.
3. Add a last image optional — Use last_image when you want to guide the final frame.
4. Choose resolution — Use 480p for faster generation, 540p for a mid-price step up, 768p for the native canvas, or 1080p for full-HD output.
5. Set duration — Choose a duration from 3 to 15 seconds.
6. Set seed optional — Use a fixed seed for reproducible results, or a negative value for random generation.
7. Submit — Generate the final image-to-video output.

Pricing

Pricing is based on generated video duration and selected resolution.

Duration is capped at 15 seconds for pricing.

Example Costs

prompt, last_image, and seed do not add separate charges.

Best Use Cases

• Image animation — Turn a still image into a short motion clip.
• Character motion — Animate portraits, characters, or illustrated subjects.
• Start-and-end-frame transitions — Use image and last_image to guide both ends of the video.
• Creative prototyping — Test motion, camera direction, and scene mood from a single image.
• Social video content — Generate short clips from static images for vertical, square, or landscape-style compositions.
• Prompt variation testing — Compare different actions or camera movements from the same start image.

Pro Tips

• Use a clear, high-quality start image for stronger subject and composition preservation.
• Add last_image when the final pose, framing, or ending state matters.
• Describe visible action clearly, such as turning, walking, looking up, zooming in, or moving through the scene.
• Include camera movement and mood when the shot direction matters.
• Use 480p for quick testing, 540p for a step up, and 768p or 1080p for higher-resolution output.
• Use a fixed seed when comparing prompt or parameter changes.

Related Models

• MiniMax H3 Text-to-Video Open Weights — Generate video with native stereo audio directly from a text prompt.
• MiniMax H3 Image-to-Video Open Weights — Animate a first-frame image with prompt-guided motion and audio.
• MiniMax H3 Reference-to-Video Open Weights — Generate video from image, video, or audio references with prompt guidance.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "resolution": "480p",
  "duration": 5
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/minimax-h3/image-to-video-spicy" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters