Create Video
Image to Video
Reference to VideoAbout MiniMax H3 HighSpeed
MiniMax H3 HighSpeed creates 4–15-second videos with sound at 768p. Start from text, an image or image, video and audio references. Image-to-video also accepts an optional closing frame.
Call it with the model name minimax/h3-highspeed/reference-to-video on POST /jobs/createTask, from $0.30.
Introduction
MiniMax H3 HighSpeed Reference to video builds a new scene from the material you send: up to 9 images, 3 video clips and 3 audio clips, named in the prompt as Image 1, Video 1, Audio 1. It returns a 4 to 15 second clip at 768p with sound.
Choose a mode by starting material
| What you have | Mode |
|---|---|
| only an idea | MiniMax H3 HighSpeed Text to video |
| a frame to animate, with an optional closing frame | MiniMax H3 HighSpeed Image to video |
| people, outfits, places, motion clips or voices | MiniMax H3 HighSpeed Reference to video |
Key features
Up to 15 references
MiniMax H3 HighSpeed accepts up to 9 images, 3 video clips (15 seconds in total) and 3 audio clips in one request. People, outfits, rooms, motion and voices can each come from a different file.
Name them in the prompt
Write "the woman from Image 1", "the motion of Video 1" or "the voice of Audio 1". The order of the lists is the order of the numbers.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The shape of the frame: wide, square or tall. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · Default: 16:9 |
duration_seconds | No | Length of the generated clip. ≥ 4 · ≤ 15 · Default: 5 |
prompt | Yes | Describe what you want to make. |
reference_audio_urls | No | Audio to match: a voice, music or a rhythm. |
reference_image_urls | No | Pictures of the people, outfits or places the result should keep. |
reference_video_urls | No | Clips whose motion, camera or style the result should follow. |
resolution | No | Choose an available output size. 768p · Default: 768p |
Pricing
Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per second |
|---|---|
| Standard | $0.06 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
Use cases
Scenes assembled from separate files
A portrait, an outfit photo and a picture of a room can be sent as three images, and MiniMax H3 HighSpeed puts that person in those clothes in that place, with a voice clip as Audio 1 if the character speaks.
The same character across clips
Send the same portrait as Image 1 in every request and MiniMax H3 HighSpeed keeps the face and outfit while the scene changes around it, which is how a recurring character or a virtual presenter stays recognisable across a series of clips.
Copying a motion
Send a short clip as Video 1 and ask MiniMax H3 HighSpeed to recreate its motion with the person from Image 1, for dance, gesture or camera moves.
Prompt guide & pro tips
One job per reference
Give each file a clear role: a face, an outfit, a room, a motion or a voice, and say that role in the prompt. Mixing several roles in one picture makes the result less predictable, so a cropped face works better than a group photo.
Audio needs a picture
Audio clips cannot be the only reference; send at least one image or video, and keep the spoken words in the prompt in double quotes. The audio sets how the voice sounds, while the prompt decides what is said and who says it.
API quick start
Call the MiniMax H3 HighSpeed API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
- Send the request. POST /jobs/createTask with model minimax/h3-highspeed/reference-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-highspeed/reference-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://media.popnow.ai/influencer/examples/ava.webp"
],
"aspect_ratio": "16:9",
"resolution": "768p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
MiniMax H3 HighSpeed API questions
How much does the MiniMax H3 HighSpeed API cost?
MiniMax H3 HighSpeed starts at $0.30 for a 5-second clip with Reference to Video, its cheapest task. The API uses a separate USD balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What are the limits of the MiniMax H3 HighSpeed · Reference to Video API?
Clip length: 4–15 s; Resolutions: 768p; Aspect ratios: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9; Reference audio: 3; Reference images: 9. Requests outside these limits are rejected before anything is charged.