minimax-h3-spicy/reference-to-video

Key Features

• Reference-guided video generation — use images, videos, and audio as style/content references.
• Up to 9 reference images, 3 reference videos, and 3 reference audio clips per generation.
• Combine multimodal references to guide both visual style and audio characteristics.
• 2K resolution output with native stereo audio, up to 15 seconds.
• Ideal for character-consistent content, style transfer, and audio-guided generation.

Parameters

How to Use

1. Upload reference materials: images for visual style, videos for motion, audio for sound.
2. Write a prompt describing how to combine the references into the output video.
3. Select duration and resolution.
4. Click Generate — the model blends your references with the text prompt.

Code Examples

import os
import requests

response = requests.post(
    "https://aircube.ai/api/v3/minimax-h3-spicy/reference-to-video",
    headers={
        "Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
    "prompt": "Character speaks naturally, following the reference voice and visual style",
    "reference_images": [
        "https://example.com/character-ref.jpg"
    ],
    "reference_audios": [
        "https://example.com/voice-ref.mp3"
    ],
    "duration": "5s",
    "resolution": "1080p"
},
    timeout=300,
)
data = response.json()

if data["success"]:
    print("ID:", data["data"]["id"], "Status:", data["data"]["status"])
else:
    print("Error:", data["error"]["message"])

Pricing

Billing rules

• 480p / 4s: $0.34.
• 512p / 4s: $0.45.
• 720p / 4s: $0.56.
• 1080p / 4s: $0.80.
• Longer durations scale proportionally.
• Failed generations are not charged.

Best Use Cases

• Character-consistent video generation across multiple scenes.
• Style transfer from reference images to video content.
• Voice/audio-guided generation using reference audio clips.
• Creating variations of existing content with consistent visual identity.

Pro Tips

• Combine multiple reference types for best results — e.g., reference images for visual style + reference audio for voice.
• Reference audio requires at least one reference image or video in the same request.
• Total reference files across all types cannot exceed 12.
• Reference videos: MP4/MOV, 2-15 seconds, max 50 MB each.

Notes

• Reference-to-video and image-to-video (first_frame/last_frame) modes are mutually exclusive.
• Audio references must be WAV or MP3, 2-15 seconds, max 15 MB each.