Minimax H3 (reference-to-video) · Video to video

← MiniMax Model name: minimax/h3/reference-to-video
Generation type: video_to_video
Endpoint: POST /api/asset_generator/

Pricing

Duration	768P	2K
4s	3.5	5.5
5s	4.0	6.5
6s	5.0	8.0
7s	6.0	9.5
8s	6.5	10.5
9s	7.5	12.0
10s	8.0	13.0
11s	9.0	14.5
12s	10.0	16.0
13s	10.5	17.0
14s	11.5	18.5
15s	12.0	19.5

Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs. These prices assume no billable reference inputs. The charge goes up for each second of reference video (up to 15 seconds) and each reference image beyond the included ones.

Quick start

The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.

curl --request POST \
  --url https://api.creatify.ai/api/asset_generator/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "model_name": "minimax/h3/reference-to-video",
    "input_params": {
      "prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
      "reference_image_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
      ],
      "reference_video_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4"
      ],
      "reference_audio_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/user/18165/2025-09-15/2d20-req-3VV9TLO6qlTOflMMQBRe-0-s.mp3"
      ]
    }
  }'

import requests

response = requests.post(
    "https://api.creatify.ai/api/asset_generator/",
    headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
    json={
        "model_name": "minimax/h3/reference-to-video",
        "input_params": {
            "prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
            "reference_image_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
            ],
            "reference_video_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4"
            ],
            "reference_audio_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/user/18165/2025-09-15/2d20-req-3VV9TLO6qlTOflMMQBRe-0-s.mp3"
            ]
        },
    },
)
print(response.json()["id"])

Input parameters

Send these fields in input_params.

string

required

Refer to reference assets by modality and order: Image 1, Image 2, Video 1, Audio 1, etc.Minimum characters: 1. Maximum characters: 7000.

string[]

Up to 9 reference images. First 5 free, each additional image billed separately.Maximum items: 9.

string[]

Up to 3 reference video clips (2-15s each, combined ≤15s). Billed per second.Maximum items: 3.

string[]

Up to 3 reference audio clips (free). Requires at least one image or video reference.Maximum items: 3.

integer

default:5

The duration of the video in seconds.Allowed values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

string

default:"adaptive"

The aspect ratio of the generated video. Use ‘adaptive’ to match reference media.Allowed values: "adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16".

string

default:"2K"

768P or 2K resolution.Allowed values: "768P", "2K".

Complete JSON schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "minLength": 1,
      "maxLength": 7000,
      "x-support-types": [
        "mentions"
      ],
      "description": "Refer to reference assets by modality and order: Image 1, Image 2, Video 1, Audio 1, etc."
    },
    "reference_image_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Reference Images",
      "maxItems": 9,
      "x-ui-name": "image_urls",
      "x-mention-prefix": "image",
      "x-free-image-count": 5,
      "min_width": 256,
      "min_height": 256,
      "max_width": 5760,
      "max_height": 5760,
      "max_file_size": 31457280,
      "max_aspect_ratio": 2.5,
      "min_aspect_ratio": 0.4,
      "description": "Up to 9 reference images. First 5 free, each additional image billed separately."
    },
    "reference_video_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Reference Videos",
      "maxItems": 3,
      "min_duration": 2,
      "max_duration": 15,
      "max_total_duration": 15,
      "x-ui-name": "video_urls",
      "description": "Up to 3 reference video clips (2-15s each, combined ≤15s). Billed per second."
    },
    "reference_audio_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Reference Audio",
      "maxItems": 3,
      "min_duration": 2,
      "max_duration": 15,
      "max_total_duration": 15,
      "x-ui-name": "audio_urls",
      "description": "Up to 3 reference audio clips (free). Requires at least one image or video reference."
    },
    "duration": {
      "enum": [
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "type": "integer",
      "title": "Duration",
      "default": 5,
      "description": "The duration of the video in seconds."
    },
    "aspect_ratio": {
      "enum": [
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "type": "string",
      "title": "Aspect Ratio",
      "default": "adaptive",
      "description": "The aspect ratio of the generated video. Use 'adaptive' to match reference media."
    },
    "resolution": {
      "enum": [
        "768P",
        "2K"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "2K",
      "description": "768P or 2K resolution.",
      "x-advance-settings": true
    }
  }
}

Response

The request returns the task with status: "initializing". Poll GET /api/asset_generator/{id}/ until status is done or failed, or pass a webhook_url to be notified. A finished task lists its files in assets and the credits it charged in credits_used.

Get Started

URL to Video

Aurora

Boreal

Stock AI Avatar

Custom Avatar

Custom Template

Asset Generator

Ad Clone

Text to Speech

IAB Images

HTML Interactive Ad

Link Parser

AI Ad Script

Stock AI Voice

Stock AI Music

Workspace

AI Shorts (Deprecated)

AI Editing (Deprecated)

Product Video (Deprecated)

Minimax H3 (reference-to-video) · Video to video

Pricing

Quick start

Input parameters

Response

​Pricing

​Quick start

​Input parameters

​Response

Pricing

Quick start

Input parameters

Response