Model API

MiniMax H3 Max

H3 Max Multi Angle turns a single image into a video with precise, keyframe-based control over the camera's orbit, elevation, and distance in 3D space

Model id

Use this in every request

minimax/h3-max/camera-controls

This model has other modes with their own ids: minimax/h3-max/text-to-video, minimax/h3-max/image-to-video, minimax/h3-max/insert-video, minimax/h3-max/extend-video, minimax/h3-max/3d-to-video.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/h3-max/camera-controls",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "prompt_expansion_mode": "balanced",
    "image_url": "https://example.com/input.png"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "minimax/h3-max/camera-controls", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","prompt_expansion_mode":"balanced","image_url":"https://example.com/input.png"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for minimax/h3-max/camera-controls
Name	Type	Description
`prompt`	string	Text prompt for video generation. When omitted or blank, defaults to preserving the frozen reference scene while only the camera moves. Default: `The same elements in the reference are rigid. Preserve every element exactly. The entire scene is frozen. Only the camera moves. no scene motion only camera motion`
`duration`	number (enum)	Video length in seconds. The output can run up to about 0.7 s longer than requested. Default: `5` One of: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
`resolution`	string (enum)	The native generation resolution, or 1080P latent refinement from a native 768P source. Default: `480P` One of: `480P`, `768P`, `1080P`
`seed`	integer	Random seed. A random seed is selected when omitted.
`sync_mode`	boolean	Return the generated video as base64 instead of a CDN URL. Default: `false`
`prompt_expansion_mode`required	string	How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt. Default: `balanced`
`image_url`required	string (image URL)	URL of the image to use as the first frame.
`camera_trajectory`	array of objects	Ordered camera keyframes. The first pose is held before its time and the final pose is held for the remainder of the video. Signed full turns are preserved, with at most 32 turns of total azimuth travel.
`free_camera_preset`	string (enum)	A fixed free-camera move. Truck, pedestal, and dolly slide the camera; pan, tilt, and roll turn it in place. The path is not editable. When this is set, camera_trajectory is ignored. Each move is one training-scale step: one near-depth unit, 30 degrees of pan, or 20 degrees of tilt or roll. One of: `truck_right`, `truck_left`, `pedestal_up`, `pedestal_down`, `dolly_in`, `dolly_out`, `pan_right`, `pan_left`, `tilt_up`, `tilt_down`, `roll_right`, `roll_left`, `s_curve_forward`

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "video", "url": "https://…", "mime_type": "video/mp4", "thumbnail_url": "https://…" }
]

Pricing

480P$0.08/ second
768P$0.13/ second
1080P$0.26/ second

The exact charge for your input comes from a quote. How charges settle