minimax-h3/image-to-video

Key Features

• Animate still images into 2K video with native stereo audio.
• First-frame and optional last-frame mode — use images as start and end keyframes for natural transitions.
• Up to 15-second video clips from source images.
• Automatic aspect ratio detection from input image dimensions (adaptive).
• High-fidelity motion generation that respects the original image content and composition.
• Built-in audio synthesis — generates synchronized sound effects and ambient audio.

Parameters

How to Use

1. Upload a high-quality source image that you want to animate.
2. Optionally upload a last-frame image for keyframe interpolation.
3. Write a prompt describing the desired motion, camera movement, and audio.
4. Select duration and resolution — the aspect ratio is automatically determined from your image.

Code Examples

import os
import requests

response = requests.post(
    "https://aircube.ai/api/v3/minimax-h3/image-to-video",
    headers={
        "Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
    "prompt": "Gentle camera zoom in, steam rising from the coffee cup, soft morning light",
    "image": "https://example.com/coffee-scene.jpg",
    "duration": "5s",
    "resolution": "2K"
},
    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

• 768p / 4s: $0.36.
• 2k / 4s: $0.52.
• Longer durations scale proportionally.
• Failed generations are not charged.

Best Use Cases

• Bringing product photos to life with motion and ambient sound.
• Creating social media video content from static photography.
• Animating artwork, illustrations, and concept art.
• Generating video transitions between two keyframe images.

Pro Tips

• The aspect ratio is automatically set to 'adaptive' based on your input image — no need to set it manually.
• Describe both visual motion AND audio in your prompt for best results.
• Use high-resolution input images (up to 5,760 px per side) for best quality.
• Supported formats: JPG, JPEG, PNG, WEBP, HEIC, HEIF (max 30 MB).
• Input image aspect ratio must be between 2:5 and 5:2.
• Use the optional last_frame_image for controlled start-to-end transitions.

Notes

• Image-to-video and reference-to-video modes are mutually exclusive.
• Input images must have an aspect ratio between 2:5 and 5:2.