# MiniMax H3 Reference-to-Video

MiniMax

Generate video guided by one to five reference images with duration, resolution and aspect-ratio controls.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use MiniMax H3 Reference-to-Video (tool ID: minimax.h3-reference-to-video). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Generate videos](https://scrollport.com/tools/ai-video-generation-api)

**Current price:** $0.1120/video second

**Availability:** Ready to run

## Tool details

**About this tool**

Guide MiniMax H3 with images of a character, product or scene and describe the action in a text prompt. Choose 768P or 2K, an exact duration and an aspect ratio. Refer to images by their order, such as reference image 1. The generated video is returned as a private MP4 artifact. The first five reference images are included in the per-second price.

**Inputs and outputs**

### Input

`duration` integer · optional

Value supplied for duration.

minimum: 4 · maximum: 15

`image_urls` array · required

One to five public HTTPS image URLs without embedded credentials, in reference order. JPG/JPEG/PNG/WEBP/HEIC/HEIF; up to 30 MB each, 256–5760 pixels per dimension, width/height ratio 0.4–2.5.

minItems: 1 · maxItems: 5

`prompt` string · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 7000

`ratio` string · optional

Value supplied for ratio.

enum: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

`resolution` string · optional

Value supplied for resolution.

enum: 768P, 2K

### Output

`note` string

Returned note value.

`video` object

Returned video value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "minimax.h3-reference-to-video",
  "input": {
    "ratio": "16:9",
    "prompt": "Use the landscape in reference image 1. A gentle breeze moves through the grass while the camera slowly pushes forward. Preserve the scene and natural lighting.",
    "duration": 4,
    "image_urls": [
      "https://images.unsplash.com/photo-1470770841072-f978cf4d019e?w=1280"
    ],
    "resolution": "768P"
  }
}
```

### Output

```
{
  "note": "video returned as an artifact",
  "video": {
    "ratio": "16:9",
    "resolution": "768P",
    "content_type": "video/mp4",
    "duration_seconds": 4
  }
}
```

**Errors and limitations**

- `invalid_input`: Use one to five public HTTPS image URLs and 4–15 whole seconds at 768P or 2K.example: {"prompt":"Use the landscape in reference image 1. A gentle breeze moves through the grass while the camera slowly pushes forward. Preserve the scene and natural lighting.","image_urls":\["https://images.unsplash.com/photo-1470770841072-f978cf4d019e?w=1280"\],"duration":4,"resolution":"768P","ratio":"16:9"}
- `upstream_output_invalid`: MiniMax H3 generated a video, but Scrollport could not preserve valid bounded video evidence.The wallet was not charged. Retry once; if it repeats, inspect the private provider evidence.

---

Canonical page: https://scrollport.com/tools/providers/minimax/h3-reference-to-video