{
	"model_id": "minimax/h3",
	"provider_id": "minimax",
	"name": "MiniMax H3",
	"description": "A multimodal video generation model supporting text-to-video, first and last frame image-to-video, and reference-to-video generation with 768P and 2K output.",
	"task": "Text-to-Video",
	"tags": [
		"Video Generation",
		"Text-to-Video",
		"Image-to-Video",
		"Reference-to-Video",
		"Multimodal",
		"2K"
	],
	"context_length": null,
	"max_output_tokens": null,
	"schema_version": "1.0.0",
	"pricing": {
		"Default (per second)": 0.08,
		"@768p (per second)": 0.08,
		"@2k (per second)": 0.13
	},
	"examples": [
		{
			"name": "Text to Video 2K",
			"description": "Generate a cinematic 2K space-opera teaser from text.",
			"input": {
				"content": [
					{
						"type": "text",
						"text": "A cinematic space-opera teaser: a fleet jumps into hyperspace above a purple nebula while a lone captain watches from a glass observation deck."
					}
				],
				"duration": 5,
				"ratio": "16:9",
				"resolution": "2K"
			},
			"output": {
				"video": "https://examples.aig.cloudflare.com/minimax/h3/text-to-video-2k.mp4"
			},
			"raw_response": {
				"task": {
					"id": "441812275253329",
					"model": "MiniMax-H3",
					"status": "succeeded",
					"created_at": 1789417263,
					"updated_at": 1789417606,
					"content": {
						"url": "https://examples.aig.cloudflare.com/minimax/h3/text-to-video-2k.mp4"
					},
					"resolution": "2K",
					"duration": 5,
					"usage": {
						"total_seconds": 5,
						"input_seconds": 0,
						"output_seconds": 5,
						"input_image_count": 0,
						"total_tokens": 260390,
						"prompt_tokens": 0,
						"completion_tokens": 260390
					},
					"ratio": "16:9",
					"task_type": "generation"
				}
			},
			"code_snippets": [
				{
					"label": "typescript",
					"language": "typescript",
					"code": "const response = await env.AI.run(\n  'minimax/h3',\n  {\n    content: [\n      {\n        type: 'text',\n        text: 'A cinematic space-opera teaser: a fleet jumps into hyperspace above a purple nebula while a lone captain watches from a glass observation deck.',\n      },\n    ],\n    duration: 5,\n    ratio: '16:9',\n    resolution: '2K',\n  },\n)\nconsole.log(response)"
				},
				{
					"label": "curl",
					"language": "bash",
					"code": "curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \\\n  --header \"Authorization: Bearer $CLOUDFLARE_API_TOKEN\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n  \"model\": \"minimax/h3\",\n  \"input\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"A cinematic space-opera teaser: a fleet jumps into hyperspace above a purple nebula while a lone captain watches from a glass observation deck.\"\n      }\n    ],\n    \"duration\": 5,\n    \"ratio\": \"16:9\",\n    \"resolution\": \"2K\"\n  }\n}'"
				}
			]
		},
		{
			"name": "First Frame Image to Video",
			"description": "Animate a supplied image as the first frame.",
			"input": {
				"content": [
					{
						"type": "text",
						"text": "Slowly push in while the leaves move gently in the breeze and warm sunlight flickers through the branches."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://filecdn.minimax.chat/public/85c96368-6ead-4eae-af9c-116be878eac3.png"
						},
						"role": "first_frame"
					}
				],
				"duration": 5,
				"resolution": "768P",
				"ratio": "adaptive"
			},
			"output": {
				"video": "https://examples.aig.cloudflare.com/minimax/h3/first-frame-image-to-video.mp4"
			},
			"raw_response": {
				"task": {
					"id": "441814879252673",
					"model": "MiniMax-H3",
					"status": "succeeded",
					"created_at": 1789417772,
					"updated_at": 1789417915,
					"content": {
						"url": "https://examples.aig.cloudflare.com/minimax/h3/first-frame-image-to-video.mp4"
					},
					"resolution": "768P",
					"duration": 5,
					"usage": {
						"total_seconds": 5,
						"input_seconds": 0,
						"output_seconds": 5,
						"input_image_count": 1,
						"total_tokens": 175765,
						"prompt_tokens": 13020,
						"completion_tokens": 162745
					},
					"ratio": "adaptive",
					"task_type": "generation"
				}
			},
			"code_snippets": [
				{
					"label": "typescript",
					"language": "typescript",
					"code": "const response = await env.AI.run(\n  'minimax/h3',\n  {\n    content: [\n      {\n        type: 'text',\n        text: 'Slowly push in while the leaves move gently in the breeze and warm sunlight flickers through the branches.',\n      },\n      {\n        type: 'image_url',\n        image_url: {\n          url: 'https://filecdn.minimax.chat/public/85c96368-6ead-4eae-af9c-116be878eac3.png',\n        },\n        role: 'first_frame',\n      },\n    ],\n    duration: 5,\n    resolution: '768P',\n    ratio: 'adaptive',\n  },\n)\nconsole.log(response)"
				},
				{
					"label": "curl",
					"language": "bash",
					"code": "curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \\\n  --header \"Authorization: Bearer $CLOUDFLARE_API_TOKEN\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n  \"model\": \"minimax/h3\",\n  \"input\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"Slowly push in while the leaves move gently in the breeze and warm sunlight flickers through the branches.\"\n      },\n      {\n        \"type\": \"image_url\",\n        \"image_url\": {\n          \"url\": \"https://filecdn.minimax.chat/public/85c96368-6ead-4eae-af9c-116be878eac3.png\"\n        },\n        \"role\": \"first_frame\"\n      }\n    ],\n    \"duration\": 5,\n    \"resolution\": \"768P\",\n    \"ratio\": \"adaptive\"\n  }\n}'"
				}
			]
		},
		{
			"name": "Last Frame Image to Video",
			"description": "Generate a transition that ends on a supplied image.",
			"input": {
				"content": [
					{
						"type": "text",
						"text": "A paper airplane flies through a city at sunset and gently lands on the desk shown in the final frame."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg"
						},
						"role": "last_frame"
					}
				],
				"duration": 6,
				"resolution": "768P",
				"ratio": "adaptive"
			},
			"output": {
				"video": "https://examples.aig.cloudflare.com/minimax/h3/last-frame-image-to-video.mp4"
			},
			"raw_response": {
				"task": {
					"id": "441808217669932",
					"model": "MiniMax-H3",
					"status": "succeeded",
					"created_at": 1789416497,
					"updated_at": 1789416694,
					"content": {
						"url": "https://examples.aig.cloudflare.com/minimax/h3/last-frame-image-to-video.mp4"
					},
					"resolution": "768P",
					"duration": 6,
					"usage": {
						"total_seconds": 6,
						"input_seconds": 0,
						"output_seconds": 6,
						"input_image_count": 1,
						"total_tokens": 208314,
						"prompt_tokens": 13020,
						"completion_tokens": 195294
					},
					"ratio": "adaptive",
					"task_type": "generation"
				}
			},
			"code_snippets": [
				{
					"label": "typescript",
					"language": "typescript",
					"code": "const response = await env.AI.run(\n  'minimax/h3',\n  {\n    content: [\n      {\n        type: 'text',\n        text: 'A paper airplane flies through a city at sunset and gently lands on the desk shown in the final frame.',\n      },\n      {\n        type: 'image_url',\n        image_url: {\n          url: 'https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg',\n        },\n        role: 'last_frame',\n      },\n    ],\n    duration: 6,\n    resolution: '768P',\n    ratio: 'adaptive',\n  },\n)\nconsole.log(response)"
				},
				{
					"label": "curl",
					"language": "bash",
					"code": "curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \\\n  --header \"Authorization: Bearer $CLOUDFLARE_API_TOKEN\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n  \"model\": \"minimax/h3\",\n  \"input\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"A paper airplane flies through a city at sunset and gently lands on the desk shown in the final frame.\"\n      },\n      {\n        \"type\": \"image_url\",\n        \"image_url\": {\n          \"url\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\"\n        },\n        \"role\": \"last_frame\"\n      }\n    ],\n    \"duration\": 6,\n    \"resolution\": \"768P\",\n    \"ratio\": \"adaptive\"\n  }\n}'"
				}
			]
		},
		{
			"name": "First and Last Frame",
			"description": "Create a controlled transition between supplied first and last frames.",
			"input": {
				"content": [
					{
						"type": "text",
						"text": "Show the character growing from childhood into adulthood through a continuous, emotional camera move."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg"
						},
						"role": "first_frame"
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg"
						},
						"role": "last_frame"
					}
				],
				"duration": 5,
				"resolution": "2K",
				"ratio": "adaptive"
			},
			"output": {
				"video": "https://examples.aig.cloudflare.com/minimax/h3/first-and-last-frame.mp4"
			},
			"raw_response": {
				"task": {
					"id": "441811301478471",
					"model": "MiniMax-H3",
					"status": "succeeded",
					"created_at": 1789416926,
					"updated_at": 1789417242,
					"content": {
						"url": "https://examples.aig.cloudflare.com/minimax/h3/first-and-last-frame.mp4"
					},
					"resolution": "2K",
					"duration": 5,
					"usage": {
						"total_seconds": 5,
						"input_seconds": 0,
						"output_seconds": 5,
						"input_image_count": 2,
						"total_tokens": 286430,
						"prompt_tokens": 26040,
						"completion_tokens": 260390
					},
					"ratio": "adaptive",
					"task_type": "generation"
				}
			},
			"code_snippets": [
				{
					"label": "typescript",
					"language": "typescript",
					"code": "const response = await env.AI.run(\n  'minimax/h3',\n  {\n    content: [\n      {\n        type: 'text',\n        text: 'Show the character growing from childhood into adulthood through a continuous, emotional camera move.',\n      },\n      {\n        type: 'image_url',\n        image_url: {\n          url: 'https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg',\n        },\n        role: 'first_frame',\n      },\n      {\n        type: 'image_url',\n        image_url: {\n          url: 'https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg',\n        },\n        role: 'last_frame',\n      },\n    ],\n    duration: 5,\n    resolution: '2K',\n    ratio: 'adaptive',\n  },\n)\nconsole.log(response)"
				},
				{
					"label": "curl",
					"language": "bash",
					"code": "curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \\\n  --header \"Authorization: Bearer $CLOUDFLARE_API_TOKEN\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n  \"model\": \"minimax/h3\",\n  \"input\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"Show the character growing from childhood into adulthood through a continuous, emotional camera move.\"\n      },\n      {\n        \"type\": \"image_url\",\n        \"image_url\": {\n          \"url\": \"https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg\"\n        },\n        \"role\": \"first_frame\"\n      },\n      {\n        \"type\": \"image_url\",\n        \"image_url\": {\n          \"url\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\"\n        },\n        \"role\": \"last_frame\"\n      }\n    ],\n    \"duration\": 5,\n    \"resolution\": \"2K\",\n    \"ratio\": \"adaptive\"\n  }\n}'"
				}
			]
		},
		{
			"name": "Multiple Reference Images",
			"description": "Use multiple reference images to preserve character appearance and style.",
			"input": {
				"content": [
					{
						"type": "text",
						"text": "The character walks through a rainy city street, preserving the character's appearance from the first reference and the visual style from the second."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/9d5c7a33fa6e_01_%E5%9B%BE1_MHGgbVga3o_gpt4o-image-1780651118146.png"
						},
						"role": "reference_image"
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/7af326902315_00_%E5%9B%BE2_YqtKbY1jpo_u4391985813_Young_male_wearing_cream_hoodie_and_dark_brown_sh_45d56ed0-d626-4c37-9a5b-77f51f374982_1.png"
						},
						"role": "reference_image"
					}
				],
				"duration": 5,
				"resolution": "2K",
				"ratio": "16:9"
			},
			"output": {
				"video": "https://examples.aig.cloudflare.com/minimax/h3/multiple-reference-images.mp4"
			},
			"raw_response": {
				"task": {
					"id": "441814469210409",
					"model": "MiniMax-H3",
					"status": "succeeded",
					"created_at": 1789417917,
					"updated_at": 1789418171,
					"content": {
						"url": "https://examples.aig.cloudflare.com/minimax/h3/multiple-reference-images.mp4"
					},
					"resolution": "2K",
					"duration": 5,
					"usage": {
						"total_seconds": 5,
						"input_seconds": 0,
						"output_seconds": 5,
						"input_image_count": 2,
						"total_tokens": 286430,
						"prompt_tokens": 26040,
						"completion_tokens": 260390
					},
					"ratio": "16:9",
					"task_type": "generation"
				}
			},
			"code_snippets": [
				{
					"label": "typescript",
					"language": "typescript",
					"code": "const response = await env.AI.run(\n  'minimax/h3',\n  {\n    content: [\n      {\n        type: 'text',\n        text: \"The character walks through a rainy city street, preserving the character's appearance from the first reference and the visual style from the second.\",\n      },\n      {\n        type: 'image_url',\n        image_url: {\n          url: 'https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/9d5c7a33fa6e_01_%E5%9B%BE1_MHGgbVga3o_gpt4o-image-1780651118146.png',\n        },\n        role: 'reference_image',\n      },\n      {\n        type: 'image_url',\n        image_url: {\n          url: 'https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/7af326902315_00_%E5%9B%BE2_YqtKbY1jpo_u4391985813_Young_male_wearing_cream_hoodie_and_dark_brown_sh_45d56ed0-d626-4c37-9a5b-77f51f374982_1.png',\n        },\n        role: 'reference_image',\n      },\n    ],\n    duration: 5,\n    resolution: '2K',\n    ratio: '16:9',\n  },\n)\nconsole.log(response)"
				},
				{
					"label": "curl",
					"language": "bash",
					"code": "curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \\\n  --header \"Authorization: Bearer $CLOUDFLARE_API_TOKEN\" \\\n  --header \"Content-Type: application/json\" \\\n  --data '{\n  \"model\": \"minimax/h3\",\n  \"input\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"The character walks through a rainy city street, preserving the character'\\''s appearance from the first reference and the visual style from the second.\"\n      },\n      {\n        \"type\": \"image_url\",\n        \"image_url\": {\n          \"url\": \"https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/9d5c7a33fa6e_01_%E5%9B%BE1_MHGgbVga3o_gpt4o-image-1780651118146.png\"\n        },\n        \"role\": \"reference_image\"\n      },\n      {\n        \"type\": \"image_url\",\n        \"image_url\": {\n          \"url\": \"https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/7af326902315_00_%E5%9B%BE2_YqtKbY1jpo_u4391985813_Young_male_wearing_cream_hoodie_and_dark_brown_sh_45d56ed0-d626-4c37-9a5b-77f51f374982_1.png\"\n        },\n        \"role\": \"reference_image\"\n      }\n    ],\n    \"duration\": 5,\n    \"resolution\": \"2K\",\n    \"ratio\": \"16:9\"\n  }\n}'"
				}
			]
		}
	],
	"default_example": null,
	"code_snippets": [],
	"supports_async": false,
	"zdr": false,
	"zdr_comment": null,
	"external_info": "https://platform.minimax.io/docs/guides/video-generation.md",
	"terms": "https://platform.minimax.io/docs/guides/terms-of-service.md",
	"cover_image_url": null,
	"metadata": {
		"Billing": "Pay-as-you-go, per output second",
		"Duration": "4-15 seconds",
		"Input Types": "Text, image, video, audio",
		"Resolutions": "768P, 2K"
	},
	"request_formats": null,
	"providers": null,
	"provider_details": [
		{
			"id": "minimax",
			"pricing": {
				"default": 0.08,
				"768p": 0.08,
				"2k": 0.13
			}
		}
	],
	"banner": null,
	"created_at": "2026-09-16 19:44:34",
	"schema": {
		"input": {
			"$schema": "https://json-schema.org/draft/2020-12/schema",
			"type": "object",
			"properties": {
				"content": {
					"minItems": 1,
					"type": "array",
					"items": {
						"oneOf": [
							{
								"type": "object",
								"properties": {
									"type": {
										"type": "string",
										"const": "text"
									},
									"text": {
										"type": "string",
										"minLength": 1,
										"maxLength": 7000
									}
								},
								"required": [
									"type",
									"text"
								],
								"additionalProperties": false
							},
							{
								"type": "object",
								"properties": {
									"type": {
										"type": "string",
										"const": "image_url"
									},
									"image_url": {
										"type": "object",
										"properties": {
											"url": {
												"type": "string",
												"minLength": 1
											}
										},
										"required": [
											"url"
										],
										"additionalProperties": false
									},
									"role": {
										"type": "string",
										"enum": [
											"first_frame",
											"last_frame",
											"reference_image"
										]
									}
								},
								"required": [
									"type",
									"image_url"
								],
								"additionalProperties": false
							},
							{
								"type": "object",
								"properties": {
									"type": {
										"type": "string",
										"const": "video_url"
									},
									"video_url": {
										"type": "object",
										"properties": {
											"url": {
												"type": "string",
												"minLength": 1
											}
										},
										"required": [
											"url"
										],
										"additionalProperties": false
									},
									"role": {
										"type": "string",
										"const": "reference_video"
									}
								},
								"required": [
									"type",
									"video_url",
									"role"
								],
								"additionalProperties": false
							},
							{
								"type": "object",
								"properties": {
									"type": {
										"type": "string",
										"const": "audio_url"
									},
									"audio_url": {
										"type": "object",
										"properties": {
											"url": {
												"type": "string",
												"minLength": 1
											}
										},
										"required": [
											"url"
										],
										"additionalProperties": false
									},
									"role": {
										"type": "string",
										"const": "reference_audio"
									}
								},
								"required": [
									"type",
									"audio_url",
									"role"
								],
								"additionalProperties": false
							}
						]
					}
				},
				"resolution": {
					"type": "string",
					"enum": [
						"768P",
						"2K"
					]
				},
				"duration": {
					"type": "integer",
					"minimum": 4,
					"maximum": 15
				},
				"ratio": {
					"type": "string",
					"enum": [
						"adaptive",
						"21:9",
						"16:9",
						"4:3",
						"1:1",
						"3:4",
						"9:16"
					]
				},
				"callback_url": {
					"type": "string",
					"format": "uri"
				}
			},
			"required": [
				"content",
				"resolution",
				"duration"
			],
			"additionalProperties": false
		},
		"output": {
			"$schema": "https://json-schema.org/draft/2020-12/schema",
			"type": "object",
			"properties": {
				"task": {
					"type": "object",
					"properties": {
						"id": {
							"type": "string"
						},
						"model": {
							"type": "string"
						},
						"status": {
							"type": "string",
							"enum": [
								"queued",
								"running",
								"succeeded",
								"failed",
								"cancelled"
							]
						},
						"error": {
							"type": "object",
							"properties": {
								"code": {
									"type": "string"
								},
								"message": {
									"type": "string"
								}
							},
							"required": [
								"code",
								"message"
							],
							"additionalProperties": false
						},
						"created_at": {
							"type": "integer",
							"minimum": -9007199254740991,
							"maximum": 9007199254740991
						},
						"updated_at": {
							"type": "integer",
							"minimum": -9007199254740991,
							"maximum": 9007199254740991
						},
						"content": {
							"type": "object",
							"properties": {
								"url": {
									"type": "string",
									"format": "uri"
								},
								"prompt": {
									"type": "string"
								}
							},
							"additionalProperties": false
						},
						"resolution": {
							"type": "string"
						},
						"duration": {
							"type": "integer",
							"minimum": -9007199254740991,
							"maximum": 9007199254740991
						},
						"usage": {
							"type": "object",
							"properties": {
								"total_seconds": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								},
								"input_seconds": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								},
								"output_seconds": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								},
								"input_image_count": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								},
								"input_audio_seconds": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								},
								"total_tokens": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								},
								"prompt_tokens": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								},
								"completion_tokens": {
									"type": "integer",
									"minimum": -9007199254740991,
									"maximum": 9007199254740991
								}
							},
							"additionalProperties": false
						},
						"ratio": {
							"type": "string"
						},
						"task_type": {
							"type": "string",
							"enum": [
								"generation",
								"regeneration",
								"h3_context_ir"
							]
						},
						"modality": {
							"type": "string",
							"enum": [
								"video",
								"text"
							]
						}
					},
					"required": [
						"id",
						"model",
						"status",
						"created_at",
						"updated_at"
					],
					"additionalProperties": {}
				}
			},
			"required": [
				"task"
			],
			"additionalProperties": false
		}
	}
}