MiniMax H3 Singularity Reference-to-Video Open Weights LoRA

Name: MiniMax H3 Singularity Reference-to-Video Open Weights LoRA | Custom LoRA Video
Brand: wavespeed-ai
SKU: wavespeed-ai/minimax-h3-singularity/reference-to-video-lora
Price: 0.15 USD
Availability: InStock

MiniMax H3 Singularity Reference-to-Video LoRA

MiniMax H3 Singularity Reference-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.

Why Choose This?

Open-weights MiniMax H3 Singularity workflow
Use the open-weights edition of MiniMax H3 Singularity through WaveSpeedAI-hosted infrastructure.
Multimodal reference guidance
Guide the output with reference images, reference videos, and reference audio.
Native stereo audio
Generate visuals and synchronized stereo audio together in one pass.
LoRA support
Load up to 3 LoRA weights per request, each with its own scale.
Reference-aware prompting
Use tags such as <Picture 1>, <Video 1>, and <Audio 1> to assign clear roles to each input.
Flexible aspect ratios
Supports landscape, vertical, square, classic, and cinematic aspect ratios.

Parameters

Parameter	Required	Description
prompt	Yes	Desired video instructions with references addressed as `<Picture 1>`, `<Video 1>`, `<Audio 1>`, plus an `Audio:` line for soundtrack guidance.
reference_images	No	Up to 9 reference image URLs.
reference_videos	No	Up to 3 reference video URLs, usable at any output resolution. Their soundtracks are used automatically.
reference_audios	No	Up to 3 standalone reference audio URLs.
aspect_ratio	No	Output aspect ratio: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, or `9:21`. Default: `16:9`.
resolution	No	Output resolution: `480p`, `540p`, `768p`, or `1080p`. Default: `480p`.
duration	No	Output duration in seconds. Range: `3–15`. Default: `5`.
seed	No	Fixed seed for reproducible output.
loras	No	Up to 3 LoRA weights. Each item uses `{path, scale}`, where `path` is a LoRA file URL.

At least one of reference_images or reference_videos is required. reference_audios can guide sound, voice, rhythm, or ambience, but audio cannot be used as the only reference input.

Reference Rules

At least one reference image or reference video is required.
Reference audio cannot be provided alone.
Reference video soundtracks are picked up automatically.
Total reference video duration is capped at 15 seconds.
Longer reference video inputs may be trimmed within the 15-second budget.

How to Use

Add reference media — Provide reference images or reference videos. Add reference audio when soundtrack, voice, rhythm, or ambience guidance is needed.
Write the prompt — Use <Picture 1>, <Video 1>, and <Audio 1> tags to explain how each reference should be used.
Choose aspect ratio — Select the output format that matches your target platform or composition.
Choose resolution — Use 480p for lower-cost generation, 540p for a mid-price step up, 768p for the model's native canvas, or 1080p for full-HD output. Reference videos work at either; they are conformed to a 480p pixel budget internally, so they stay affordable at 768p.
Set duration — Choose a duration from 3 to 15 seconds.
Add LoRAs optional — Provide up to 3 LoRA files with individual scale values.
Set seed optional — Use a fixed seed when reproducibility is needed.
Submit — Generate the final MP4 with native stereo audio.

Pricing

Pricing is based on generated video duration, reference video duration, selected resolution, and the number of reference images and audios.

Item	Price
Output video (480p)	$0.06 / second
Output video (540p)	$0.09 / second
Output video (768p)	$0.135 / second
Output video (1080p)	$0.27 / second
Reference video (480p output)	$0.06 / second
Reference video (540p output)	$0.09 / second
Reference video (768p output)	$0.135 / second
Reference video (1080p output)	$0.27 / second
Reference image	$0.02 each
Reference audio	$0.02 each

Output duration and total reference video duration are each capped at 15 seconds for pricing. Reference video duration is rounded up to the next whole second.

Example: a 10s 480p output with 2 reference images and a 5s reference video costs 10 × $0.06 + 2 × $0.02 + 5 × $0.06 = $0.94.

Best Use Cases

Reference-guided video generation — Use images, videos, and audio to guide identity, setting, motion, or sound.
Character-consistent scenes — Generate videos that follow character or style references.
Motion transfer and camera guidance — Use reference videos to guide motion, pacing, or camera rhythm.
Audio-guided generation — Use reference audio to guide music, voice, ambience, or sound direction.
LoRA-guided creative workflows — Combine references with LoRA weights for stronger style or subject control.
Social and cinematic clips — Generate short videos for vertical, landscape, square, or cinematic layouts.

Pro Tips

Assign a clear job to every reference in the prompt.
Use exact tags such as <Picture 1>, <Video 1>, and <Audio 1>.
Write prompts as a timeline with timestamped beats.
Add an Audio: line to control soundtrack, ambience, voice, and effects.
Use reference videos when motion, gesture, pacing, or camera behavior matters.
Use reference images when identity, subject appearance, setting, or style matters.
Use reference audio when rhythm, mood, voice, or sound design matters.
Use a fixed seed when comparing reference combinations or LoRA scale changes.
Keep LoRA combinations focused; too many strong LoRAs can reduce control.

Model

Powered by the community MiniMax H3 Singularity v1.3 checkpoint. Supports the same reference input format as WaveSpeed MiniMax H3.

Related Models

Minimax H3 Singularity Reference To Video Lora API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/minimax-h3-singularity/reference-to-video-lora with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Minimax H3 Singularity Reference To Video Lora below.

HTTP example

set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "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/reference-to-video-lora" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; 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 has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  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

Node.js example

const submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/minimax-h3-singularity/reference-to-video-lora";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "16:9",
        "resolution": "480p",
        "duration": 5
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}

Python example

import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "resolution": "480p",
    "duration": 5
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/minimax-h3-singularity/reference-to-video-lora", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Minimax H3 Singularity Reference To Video Lora API — Frequently asked questions

What is the Minimax H3 Singularity Reference To Video Lora API?

Minimax H3 Singularity Reference To Video Lora is a WaveSpeedAI model for AI inference, exposed as a REST API on WaveSpeedAI. MiniMax H3 Singularity Open Weights Reference to Video with custom LoRA support generates coherent 480P / 540P / 768P videos from prompts and multimodal references, guided by up to 9 reference images, 3 reference videos, and 3 reference audios, with native stereo audio and flexible reference-based video generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Minimax H3 Singularity Reference To Video Lora API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/minimax-h3-singularity-reference-to-video-lora.

How much does Minimax H3 Singularity Reference To Video Lora cost per run?

Minimax H3 Singularity Reference To Video Lora starts at $0.15 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Minimax H3 Singularity Reference To Video Lora accept?

Key inputs: `prompt`, `aspect_ratio`, `resolution`, `duration`, `seed`, `reference_images`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/minimax-h3-singularity-reference-to-video-lora.

How do I get started with the Minimax H3 Singularity Reference To Video Lora API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Minimax H3 Singularity Reference To Video Lora outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

wavespeed-ai/

ExamplesView all

Related Models

README

MiniMax H3 Singularity Reference-to-Video LoRA

Why Choose This?

Parameters

Reference Rules

How to Use

Pricing

Best Use Cases

Pro Tips

Model

Related Models

Minimax H3 Singularity Reference To Video Lora API — Quick start

Minimax H3 Singularity Reference To Video Lora API — Frequently asked questions

Learn More

Legal

Resources

Models

Tools