Minimax H3 Singularity Image To Video LoRA API Documentation

Minimax H3 Singularity Image To Video LoRA API Documentation

Playground

MiniMax H3 Singularity Open Weights Image to Video animates a first-frame image, optionally with last-frame guidance, into coherent 480P / 540P / 768P videos with native stereo audio, 5-15 second duration, flexible aspect ratios, and per-second billing. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

MiniMax H3 Singularity Image-to-Video LoRA Open Weights runs the open-weights edition of MiniMax H3 Singularity with LoRA support on WaveSpeedAI. This endpoint is separate from the official minimax/h3 API and uses its own 480p / 768p / 1080p resolution options and per-second pricing.

MiniMax H3 Singularity generates video and native stereo audio in a single pass. Provide a first-frame image plus a prompt, and the model animates the scene with synchronized dialogue, sound effects, music, or ambience. You can also provide an optional last_image to guide the ending frame.

Why Choose This?

• Open-weights MiniMax H3 Singularity workflow
  Use the open-weights edition of MiniMax H3 Singularity through WaveSpeedAI-hosted infrastructure.

• Image-to-video generation
  Animate a first-frame image into a complete video with prompt-guided motion.

• Native stereo audio
  Generate visuals and synchronized stereo audio together in one pass.

• Optional last-frame control
  Use last_image to guide the final frame and create a controlled start-to-end transition.

• LoRA support
  Load up to 3 LoRA weights per request, each with its own scale.

• Prompt-controlled soundtrack
  Use an Audio: line in the prompt to guide music, dialogue, ambience, and sound effects.

Parameters

How to Use

1. Upload the first-frame image — Provide the image that should define the starting frame, subject, composition, and style.
2. Add last-frame guidance optional — Use last_image when you want to control the final frame or ending direction.
3. Write the prompt — Describe motion, timing, camera movement, and audio direction.
4. Choose resolution — Use 480p for lower-cost generation, 540p for a mid-price step up, 768p for higher-resolution output, or 1080p for full-HD output.
5. Set duration — Choose a duration from 3 to 15 seconds.
6. Add LoRAs optional — Provide up to 3 LoRA files with individual scale values.
7. Set seed optional — Use a fixed seed when reproducibility is needed.
8. Submit — Generate the final MP4 with native stereo audio.

Pricing

Pricing is based on generated video duration and selected resolution.

Duration is capped at 15 seconds for pricing. LoRA loading does not add a separate charge.

Best Use Cases

• LoRA-guided image animation — Animate a reference image while applying custom styles, subjects, or concept LoRAs.
• Character motion — Bring portraits, characters, or illustrated subjects to life with synchronized audio.
• Start-and-end-frame control — Use image and last_image to guide both the opening and ending of the video.
• Music and audio-driven scenes — Generate video with native stereo ambience, dialogue, sound effects, or music.
• Creative prototyping — Test motion direction, camera movement, and soundtrack ideas from a still image.
• Social video content — Generate short clips for portrait, landscape, square, or cinematic formats.

Pro Tips

• Use a clear, well-lit first-frame image for stronger subject preservation.
• Use last_image when the final pose, composition, or ending beat matters.
• Write prompts as a timeline with clear timestamped motion beats.
• Include an Audio: line to guide soundtrack, ambience, voice, and effects.
• Use action verbs instead of only describing mood or visual style.
• Keep the first test short, then increase duration once the motion direction works.
• Use a fixed seed when comparing LoRA scale or prompt changes.
• Start LoRA scale around 0.8–1.0, then adjust based on the strength of the LoRA effect.

Related Models

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

Reference

• How to train your LoRA?
• How to use your LoRA?

Powered by the community MiniMax H3 Singularity v1.3 checkpoint. First-frame conditioning follows the input image; reference-to-video is available separately.

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'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "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-singularity/image-to-video-lora" \
  -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