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

Run the open-weights edition of MiniMax H3 on WaveSpeedAI’s own GPU infrastructure. This endpoint is separate from the official minimax/h3 API: same model family, independently hosted, with its own 480p/768p resolutions and per-second pricing.

MiniMax H3 Spicy Image-to-Video animates a reference image into high-quality cinematic clips with smooth, expressive motion. The prompt is automatically enhanced for dynamic, unrestricted animation, and picture plus native stereo audio are generated in a single pass.

Key Features

Expressive motion - prompts are automatically optimized for dynamic, unrestricted animations with stable aesthetics.
Native audio - synchronized stereo audio generated in the same pass.
First/last frame control - optionally supply last_image to steer the clip toward a specific final frame.
3-15 second clips at 480p or 768p, billed per second.

Inputs

Field	Required	Description
`image`	yes	Start image URL
`prompt`	no	Scene, action, and mood (auto-enhanced)
`last_image`	no	Target last-frame image URL
`duration`	no	Clip length in seconds (3-15, default 5)
`resolution`	no	`480p` (default) or `768p`
`seed`	no	Negative for random

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

Parameter	Type	Required	Default	Range	Description
image	string	Yes		-	Start image URL to guide the video generation. The output canvas follows this image's aspect ratio.
prompt	string	No		-	Describe the scene, action, camera movement, and mood for the video. The prompt is automatically enhanced for expressive, unrestricted motion.
last_image	string	No	-	-	Optional last-frame image URL. When provided, the video interpolates from the first frame to this frame.
resolution	string	No	480p	480p, 768p	Output video resolution. 768p is the model's native canvas; 480p is a faster, lower-cost tier.
duration	integer	No	5	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15	Output video duration in seconds.
seed	integer	No	-	-	The random seed to use for the generation. A negative value means a random seed will be used.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Output values, usually URL strings; some models return text strings or structured result objects (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.status	string	Task status. `completed` is successful; `failed`, `cancelled`, `timeout`, and `deleted` are failure terminal statuses.
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction
data.model	string	Model ID used for the prediction
data.outputs	array<string \| object>	Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model.
data.urls	object	Object containing related API endpoints
data.status	string	Status: `completed` is successful; `failed`, `cancelled`, `timeout`, and `deleted` are failure terminal statuses
data.created_at	string	ISO timestamp of when the request was created
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Overview