Model API

MiniMax H3 Reference to video API

MiniMax H3 Reference to video API on Phosor. Guide a clip with reference images or videos, with optional audio references. Address uploaded references in your prompt using <Picture n>, <Video n> and <Audio n>. Explore API inputs, documentation and current pricing.

API model ID
minimax/h3/reference-to-video
Capabilities
reference-to-video

Browse model information and examples without an account. Sign in to generate.

Model example

When to use reference to video

Combine visual references for a subject, scene or movement in one request.

Required inputs: A prompt and at least one reference image or video. Audio references are optional.

This is H3. A Turbo option is also available for this input mode. Compare your own outputs and current rates when choosing.

Compare all MiniMax H3 modes →

API inputs and controls

  • prompt
  • reference_image_urls
  • reference_video_urls
  • reference_audio_urls

Set resolution_tier, aspect_ratio and duration to control the output. The playground shows current supported choices and reference limits.

See the complete parameter reference and request examples before integrating.

MiniMax H3 Reference to video API request example

Set PHOSOR_API_KEY to your API key, then submit this request from your terminal. Generation is billed at current rates.

Replace the example.com URLs with accessible URLs for your own images. Use <Picture 1> and <Picture 2> in the same order as the reference images.

curl -X POST https://phosor.ai/api/v1/inference/submit \
  -H "X-API-Key: $PHOSOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/h3/reference-to-video",
  "prompt": "Follow the hiker in <Picture 1> through the snowy landscape in <Picture 2>; slow tracking shot.",
  "reference_image_urls": [
    "https://example.com/subject.png",
    "https://example.com/scene.png"
  ],
  "duration": 5,
  "resolution_tier": "480p",
  "aspect_ratio": "16:9"
}'

The response includes a request_id. Use it to check request status and retrieve the video result. See the API reference for all supported controls.

API access

Use minimax/h3/reference-to-video as the model ID in your API request. Authenticate with an X-API-Key header, submit your request, then check its status and retrieve the result.

See current pricing for output and reference input charges.

Explore more models