> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routerbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax-H3 — Reference to Video

> Generate a 2K video that keeps a subject/character consistent from a reference image with MiniMax-H3.

|              |                                   |
| ------------ | --------------------------------- |
| **Model ID** | `minimax/minimax-h3-r2v`          |
| **Family**   | `minimax-h3`                      |
| **Task**     | `reference-to-video`              |
| **Modality** | Video                             |
| **Upstream** | MiniMax-H3 (official MiniMax API) |

<Note>
  MiniMax-H3 reference-to-video takes a subject/character reference image and
  keeps that identity consistent across the generated 2K clip, driven by your
  text prompt. Unlike image-to-video, the reference image is not used as the
  literal first frame. Clips are billed per second of output.
</Note>

## Endpoint

```http theme={null}
POST https://routerbase.com/v1/videos/generations
```

Async — returns `{id, status: "pending"}`; poll
`GET /v1/videos/generations/{id}` until `success` or `failed`.

## Parameters

<ParamField body="prompt" type="string" required>
  Text prompt describing the scene and action for the referenced subject.
  Max 7000 characters.
</ParamField>

<ParamField body="image_urls" type="string[]" required>
  A single-element array with the URL of the subject/character reference image
  whose identity should be preserved across the clip.
</ParamField>

<ParamField body="duration" type="&#x22;6&#x22; | &#x22;10&#x22;" default="&#x22;6&#x22;">
  Length of the generated clip in seconds. Drives the price (billed per
  second of output).
</ParamField>

<ParamField body="resolution" type="&#x22;2K&#x22;" default="&#x22;2K&#x22;">
  Output resolution.
</ParamField>

<ParamField body="aspect_ratio" type="&#x22;16:9&#x22; | &#x22;4:3&#x22; | &#x22;1:1&#x22; | &#x22;3:4&#x22; | &#x22;9:16&#x22; | &#x22;21:9&#x22; | &#x22;adaptive&#x22;" default="&#x22;16:9&#x22;">
  Aspect ratio. Defaults to a concrete `16:9`; `adaptive` is also accepted.
</ParamField>

## Example

```bash theme={null}
curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-h3-r2v",
    "prompt": "the same character walking through a neon-lit market at night",
    "image_urls": ["https://example.com/character-reference.png"],
    "duration": "6",
    "resolution": "2K",
    "ratio": "16:9"
  }'
```

```json theme={null}
{ "id": "task_abc123…", "status": "pending", "model": "minimax/minimax-h3-r2v" }
```

Poll until terminal:

```bash theme={null}
curl https://routerbase.com/v1/videos/generations/task_abc123… \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY"
```

```json theme={null}
{
  "id": "task_abc123…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}
```