Does MiniMax H3 support text-to-video generation?

是的。MiniMax H3 支援使用文字、圖像、影片與音訊輸入的多模態影片生成。它可以根據自然語言指令生成影片，同時維持視覺與音訊元素的一致性。

What makes MiniMax H3 different from traditional AI video models?

MiniMax H3 將文字、圖像、影片與音訊整合為一套統一的多模態生成系統。它支援原生立體聲音訊生成、影片編輯與動作遷移，而不僅僅是基於提示的影片創作。

How long and what resolution videos can MiniMax H3 generate?

根據 MiniMax 的公開發布資訊，MiniMax H3 可生成最長 15 秒、解析度最高達 2K 的影片。

Can MiniMax H3 perform image-to-video generation?

是的。MiniMax H3 支援基於圖像的影片生成流程，允許使用者提供參考圖像，在保留主體一致性的同時生成動畫影片序列。

How does MiniMax H3 compare with Sora 2 and Seedance 2.0?

MiniMax H3 著重於可控的多模態生成、原生音訊與開放權重可用性。Sora 強調電影級模擬品質，而 Seedance 著重於創意影片生成與基於參考的工作流程。

Is MiniMax H3 suitable for commercial video production?

是的。MiniMax H3 面向廣告、電商、產品可視化、遊戲內容與 AI 輔助電影製作等工作流程而設計。

Does MiniMax H3 provide an API for developers?

MiniMax 提供影片生成 API，支援非同步任務建立、狀態查詢與檔案擷取等工作流程。H3 專用 API 的可用性取決於供應方的上線安排。

Can developers integrate MiniMax H3 through CometAPI?

是的。CometAPI 提供統一的 API 存取層，使開發者能透過一致的介面整合 AI 模型，並更輕鬆地管理影片生成工作流程。

MiniMax

可使用

minimax-h3

MiniMax H3 API

minimax-h3 是一款為高品質創意製作而設計的全新影片生成模型。它在提示詞理解、視覺一致性、畫面運動的流暢度，以及參考圖像控制的靈活性方面均有提升，適用於電影級影片生成工作流程。

起始價格

$0.1 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

Aug 6, 2026

MiniMax

概覽

MiniMax H3 的實用總覽,涵蓋重要行為與整合注意事項。

MiniMax H3 的技術規格

項目	MiniMax H3
模型系列	MiniMax H Series
模型類型	多模態影片生成模型
提供方	MiniMax
輸入模態	文字、圖片、影片、音訊
輸出	具備音訊的生成影片
最高影片解析度	最高至 2K
最長時長	最高至 15 秒
音訊生成	原生立體聲
影片能力	文生影片、圖生影片、影片編輯、動作遷移
權重可用性	計劃開放權重發布
主要應用	廣告、電商、產品設計、遊戲、創意製作

來源：MiniMax 公告與技術說明.

什麼是 MiniMax H3？

MiniMax H3 是由 MiniMax 開發的多模態影片生成基礎模型。不同於僅將提示轉換為片段的傳統文生影片系統，H3 著重於導演級可控性，結合文字指令、參考圖片、既有影片片段與音訊信號等多種輸入格式。

該模型面向商業影片製作、遊戲素材創作、廣告生成與 AI 輔助電影製作等專業創作流程。它可生成最長 15 秒、最高 2K 解析度並具同步立體聲的影片。

MiniMax H3 的主要特性

1. 多模態影片理解與生成

MiniMax H3 接受多種創意輸入形式：

文字描述
參考圖片
現有影片素材
音訊參考

與僅基於提示的傳統生成系統相比，這使使用者能創作更具可控性的影片輸出。

2. 原生視聽生成

不同於許多需使用獨立音訊合成管線的影片生成模型，H3 支援原生立體聲生成。

這使得可實現：

對話驅動場景
環境音效
電影氛圍
更佳的音畫同步

3. 影片編輯與動作遷移

H3 支援編輯現有內容，並在影片間轉移動作特徵。

示例流程：

從參考素材中轉移人物動作
修改現有影片場景
套用動作風格
生成既有片段的變體

4. 開放權重部署潛力

MiniMax 宣布計劃開放 H3 模型權重，使研究人員與開發者能自訂模型，而非僅依賴託管推理 API。

社群測試已透過 ComfyUI 探索本地部署流程並優化推理管線。

5. 高解析度影片生成

MiniMax H3 支援生成最高 2K 解析度，瞄準專業內容製作流程。

相較於早期的消費級 AI 影片工具，更高解析度可支援：

品牌廣告
產品行銷
電影前期預視化
專業社群媒體內容

MiniMax H3 基準測試表現

目前，MiniMax 尚未發布可與下列基準相比較的標準化測試結果：

VBench
MovieGenBench
EvalCrafter
Video-MME

因此，尚無經驗證的公開分數。

不過，MiniMax 報告了多項能力優勢：

能力	MiniMax H3
2K 影片生成	支援
原生音訊	支援
文生影片	支援
圖生影片	支援
影片編輯	支援
動作遷移	支援

MiniMax H3 與 Sora、Veo、Kling 的比較

模型	提供方	主要優勢	最適用於
MiniMax H3	MiniMax	多模態影片 + 音訊 + 編輯	商業影片創作
Sora	OpenAI	電影級寫實與世界模擬	創意電影製作
Veo	Google	高品質影片理解	企業級媒體生成
Kling	Kuaishou	角色動作與寫實度	短影片/社群內容

MiniMax H3 與 Sora

MiniMax H3 更著重於：

開放生態
商業化生成
多模態控制
影片編輯工作流程

Sora 更著重於：

物理模擬
電影級一致性
複雜場景生成

MiniMax H3 與 Kling

與 Kling 相比：

MiniMax H3 著重於：

音訊整合
多模態輸入
專業流程支援

Kling 在以下方面具備強項：

人物動作
角色動畫
消費級影片創作

MiniMax H3 的使用案例

AI 廣告製作

行銷團隊可生成：

產品廣告片
品牌影片
社群媒體廣告

流程：

產品圖片 → 提示詞 → 行銷影片

電商影片生成

線上賣家可自動生成：

產品展示
生活情境場景
宣傳短片

遊戲開發

MiniMax H3 可協助：

角色動畫
電影式預告片
概念視覺化

電影前期預視化

導演可快速測試：

鏡位角度
場景設計
分鏡腳本

如何透過 CometAPI 使用 MiniMax H3 API

CometAPI 為 AI 模型提供統一的 API 存取層，使開發者無需維護多個供應商 SDK，即可整合新興的影片生成模型。

透過 CometAPI 使用 MiniMax H3 與其他影片生成 API 的工作流程相同：

步驟 1：取得 CometAPI API 金鑰

在 CometAPI 註冊帳號。
前往 API 控制台。
建立 API 金鑰。
使用生成的金鑰進行驗證。

示例：

Authorization: Bearer YOUR_COMETAPI_API_KEY

步驟 2：發送 MiniMax H3 影片生成請求

MiniMax 風格的影片生成 API 通常採用非同步任務架構：

提交生成請求。
接收 task_id。
查詢生成狀態。
取得生成的影片檔案。

MiniMax 官方影片 API 亦遵循此工作流程模式。

請參考 MiniMax H3 API 章節以取得示例請求的詳細資訊。

步驟 3：查詢影片生成狀態

提交任務後：

{
  "task_id": "xxxxxxxx",
  "status": "processing"
}

輪詢任務狀態直至完成。

成功回應：

{
  "status": "success",
  "file_id": "video_xxxxx"
}

步驟 4：取得生成的影片

可透過回傳的檔案 ID 存取完成的影片。

為何透過 CometAPI 使用 MiniMax H3 API？

1. 統一存取多個 AI 影片模型

開發者可與其他影片模型一同整合 MiniMax H3：

Seedance
Kling
Sora
Veo
Runway

無需維護各自獨立的 API 實作。

2. 簡化 API 管理

無需處理：

不同的驗證系統
不同的請求格式
不同的 SDK

開發者只需使用單一 API 介面。

3. 更快速的模型切換

AI 影片品質快速演進。

CometAPI 使應用程式可在不重建整個生產管線的情況下，嘗試不同的生成模型。

4. 友善開發者的工作流程

典型應用：

AI 影片 SaaS 平台
行銷自動化工具
電商內容生成器
AI 電影製作工具
社群媒體影片生成器

常見問題

定價

先參考上方的單次執行預估,再查看完整的 CometAPI 與官方價格比較。

5 秒測試

$0.5

預估 CometAPI 使用費用

10 秒測試

$1.00

預估 CometAPI 使用費用

15 秒測試

$1.50

預估 CometAPI 使用費用

MiniMax H3 的定價

探索 MiniMax H3 的競爭性定價，專為滿足各種預算和使用需求而設計。我們靈活的方案確保您只需為實際使用量付費，讓您能夠隨著需求增長輕鬆擴展。了解 MiniMax H3 如何在保持成本可控的同時提升您的專案效果。

Resolution	Comet Price (USD / Second)
768p	Per Second: $0.08
2K	Per Second: $0.13

API

複製可用的端點與程式碼範例,需要完整參數時再開啟完整 API 參考文件。

一個 API,直接對接正式環境模型

只需驗證一次,即可呼叫模型端點,並在各供應商間維持一致的計費與監控流程。

POST/v1/videosGET/v1/videos/{task_id}/contentGET/v1/videos/{task_id}

MiniMax H3 的範例程式碼和 API

存取完整的範例程式碼和 API 資源，以簡化您的 MiniMax H3 整合流程。我們詳盡的文件提供逐步指引，協助您在專案中充分發揮 MiniMax H3 的潛力。

POST

/v1/videos

GET

/v1/videos/{task_id}/content

GET

/v1/videos/{task_id}

#!/usr/bin/env bash
set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

cURL Code Example

#!/usr/bin/env bash
set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

Python Code Example

import os
import time
from pathlib import Path

import requests


api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}


def get(path: str, timeout: int) -> requests.Response:
    for attempt in range(3):
        try:
            response = requests.get(
                f"{base_url}{path}", headers=headers, timeout=timeout
            )
            response.raise_for_status()
            return response
        except requests.RequestException:
            if attempt == 2:
                raise
            time.sleep(2)
    raise RuntimeError("unreachable")

# 1. Create the task.
form = {
    "model": (None, "minimax-h3"),
    "prompt": (
        None,
        "A cinematic view of clouds moving over green mountains, "
        "locked camera, no text.",
    ),
    "seconds": (None, "5"),
    "size": (None, "1344x768"),
}
if image_url := os.getenv("MINIMAX_H3_IMAGE_URL"):
    form["images"] = (None, image_url)

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files=form,
    timeout=60,
)
response.raise_for_status()
task_id = response.json()["id"]
print(f"Task: {task_id}")

# 2. Poll until the task finishes.
while True:
    response = get(f"/v1/videos/{task_id}", timeout=30)
    task = response.json()
    status = task["status"]
    print(f"Status: {status}")
    if status == "failed":
        raise RuntimeError(task)
    if status == "completed":
        break
    time.sleep(10)

# 3. Download the completed video.
response = get(f"/v1/videos/{task_id}/content", timeout=300)
output = Path(f"{task_id}.mp4")
output.write_bytes(response.content)
print(f"Saved: {output}")

JavaScript Code Example

import fs from "node:fs";

const apiKey = process.env.COMETAPI_KEY;
const baseUrl = "https://api.cometapi.com";
const headers = { Authorization: `Bearer ${apiKey}` };
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function get(path) {
  for (let attempt = 0; attempt < 3; attempt += 1) {
    try {
      const result = await fetch(`${baseUrl}${path}`, { headers });
      if (!result.ok) throw new Error(`${result.status} ${await result.text()}`);
      return result;
    } catch (error) {
      if (attempt === 2) throw error;
      await sleep(2000);
    }
  }
  throw new Error("unreachable");
}

// 1. Create the task.
const form = new FormData();
form.append("model", "minimax-h3");
form.append(
  "prompt",
  "A cinematic view of clouds moving over green mountains, locked camera, no text.",
);
form.append("seconds", "5");
form.append("size", "1344x768");
if (process.env.MINIMAX_H3_IMAGE_URL) {
  form.append("images", process.env.MINIMAX_H3_IMAGE_URL);
}

let response = await fetch(`${baseUrl}/v1/videos`, {
  method: "POST",
  headers,
  body: form,
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const taskId = (await response.json()).id;
console.log(`Task: ${taskId}`);

// 2. Poll until the task finishes.
while (true) {
  response = await get(`/v1/videos/${taskId}`);
  const task = await response.json();
  console.log(`Status: ${task.status}`);
  if (task.status === "failed") throw new Error(JSON.stringify(task));
  if (task.status === "completed") break;
  await sleep(10000);
}

// 3. Download the completed video.
response = await get(`/v1/videos/${taskId}/content`);
const output = `${taskId}.mp4`;
fs.writeFileSync(output, Buffer.from(await response.arrayBuffer()));
console.log(`Saved: ${output}`);

功能

在選擇架構或評估正式環境負載前,先掌握模型的關鍵資訊。

支援的功能

現有模型 API 回傳的功能。

text-to-video

image-to-video

輸入與輸出

輸入

text

輸出

video

正式環境資訊

供應商: MiniMax
上下文: 依模型而定
商業使用: 支援

應用場景

將 MiniMax H3 用於符合其 video 能力的正式工作流程,並在長期整合前比較其他選項。

文字轉影片的概念與社群內容

產品展示與電影感分鏡

圖像轉影片動態與創意迭代

其他模型

比較 CometAPI 提供的其他模型,在品質、延遲、功能與價格間取得平衡。

開啟模型比較 →

Aliyun

Happy Horse 1.1

HappyHorse 1.1 是一款面向專業內容創作、廣告、短片、社群媒體製作與敘事的多模態影片生成模型。它在 HappyHorse 1.0 的基礎上擴展能力——該版本曾在獨立的影片生成評測中名列前茅，因而獲得廣泛關注——並具備更強的場景連貫性與更高的視覺保真度。

查看模型

Bytedance

Seedance 2-0

Seedance 2.0 是 ByteDance 的新一代多模態影片基礎模型，聚焦於電影級、多鏡頭敘事的影片生成。有別於單鏡頭的文本轉影片示範，Seedance 2.0 著重於基於參考的控制（圖像、短片、音訊）、跨鏡頭的角色與風格一致性，以及原生的聲畫同步——旨在使 AI 影片可用於專業創作與預視化工作流程。

查看模型

Aliyun

Happy Horse 1.0

Happy Horse 1.0 — 一款高品質的影音生成模型，支援文字轉影片與圖片轉影片創作。它可生成畫面、音訊與口型的同步效果，適用於短片、廣告創意與產品展示。

查看模型

Google

Gemini omni fast

Gemini Omni Fast 是一款輕量級多模態影片生成模型，旨在用於快速且靈活的內容創作。它支援多種輸入類型，可高效生成影片，適用於互動式與迭代式的工作流程。

查看模型

Vidu

Vidu Q3

Vidu Q3 是一款專為高品質內容創作而設計的影片生成模型，具備出色的視覺真實感與高提示遵循度。它適用於創意影片製作與故事敘事等應用。

查看模型

Vidu

Vidu Q3 Turbo

Vidu Q3 Turbo 是 Vidu Q3 的優化版本，旨在提供更快的影片生成。它在顯著提升速度的同時保持良好的視覺品質，使其適用於快速迭代與大規模生產。

查看模型

Uptime

在正式上線前,查看即時心跳資料、端點可用性與實測回應時間。

版本

在鎖定正式環境整合版本前,先查看可用的模型識別碼。

minimax-h3

持續探索

比較模型,繼續你的研究

MiniMax

可使用

minimax-h3

MiniMax H3 API

起始價格

$0.1 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

Aug 6, 2026

MiniMax

概覽

MiniMax H3 的實用總覽,涵蓋重要行為與整合注意事項。

MiniMax H3 的技術規格

項目	MiniMax H3
模型系列	MiniMax H Series
模型類型	多模態影片生成模型
提供方	MiniMax
輸入模態	文字、圖片、影片、音訊
輸出	具備音訊的生成影片
最高影片解析度	最高至 2K
最長時長	最高至 15 秒
音訊生成	原生立體聲
影片能力	文生影片、圖生影片、影片編輯、動作遷移
權重可用性	計劃開放權重發布
主要應用	廣告、電商、產品設計、遊戲、創意製作

來源：MiniMax 公告與技術說明.

什麼是 MiniMax H3？

該模型面向商業影片製作、遊戲素材創作、廣告生成與 AI 輔助電影製作等專業創作流程。它可生成最長 15 秒、最高 2K 解析度並具同步立體聲的影片。

MiniMax H3 的主要特性

1. 多模態影片理解與生成

MiniMax H3 接受多種創意輸入形式：

文字描述
參考圖片
現有影片素材
音訊參考

與僅基於提示的傳統生成系統相比，這使使用者能創作更具可控性的影片輸出。

2. 原生視聽生成

不同於許多需使用獨立音訊合成管線的影片生成模型，H3 支援原生立體聲生成。

這使得可實現：

對話驅動場景
環境音效
電影氛圍
更佳的音畫同步

3. 影片編輯與動作遷移

H3 支援編輯現有內容，並在影片間轉移動作特徵。

示例流程：

從參考素材中轉移人物動作
修改現有影片場景
套用動作風格
生成既有片段的變體

4. 開放權重部署潛力

MiniMax 宣布計劃開放 H3 模型權重，使研究人員與開發者能自訂模型，而非僅依賴託管推理 API。

社群測試已透過 ComfyUI 探索本地部署流程並優化推理管線。

5. 高解析度影片生成

MiniMax H3 支援生成最高 2K 解析度，瞄準專業內容製作流程。

相較於早期的消費級 AI 影片工具，更高解析度可支援：

品牌廣告
產品行銷
電影前期預視化
專業社群媒體內容

MiniMax H3 基準測試表現

目前，MiniMax 尚未發布可與下列基準相比較的標準化測試結果：

VBench
MovieGenBench
EvalCrafter
Video-MME

因此，尚無經驗證的公開分數。

不過，MiniMax 報告了多項能力優勢：

能力	MiniMax H3
2K 影片生成	支援
原生音訊	支援
文生影片	支援
圖生影片	支援
影片編輯	支援
動作遷移	支援

MiniMax H3 與 Sora、Veo、Kling 的比較

模型	提供方	主要優勢	最適用於
MiniMax H3	MiniMax	多模態影片 + 音訊 + 編輯	商業影片創作
Sora	OpenAI	電影級寫實與世界模擬	創意電影製作
Veo	Google	高品質影片理解	企業級媒體生成
Kling	Kuaishou	角色動作與寫實度	短影片/社群內容

MiniMax H3 與 Sora

MiniMax H3 更著重於：

開放生態
商業化生成
多模態控制
影片編輯工作流程

Sora 更著重於：

物理模擬
電影級一致性
複雜場景生成

MiniMax H3 與 Kling

與 Kling 相比：

MiniMax H3 著重於：

音訊整合
多模態輸入
專業流程支援

Kling 在以下方面具備強項：

人物動作
角色動畫
消費級影片創作

MiniMax H3 的使用案例

AI 廣告製作

行銷團隊可生成：

產品廣告片
品牌影片
社群媒體廣告

流程：

產品圖片 → 提示詞 → 行銷影片

電商影片生成

線上賣家可自動生成：

產品展示
生活情境場景
宣傳短片

遊戲開發

MiniMax H3 可協助：

角色動畫
電影式預告片
概念視覺化

電影前期預視化

導演可快速測試：

鏡位角度
場景設計
分鏡腳本

如何透過 CometAPI 使用 MiniMax H3 API

CometAPI 為 AI 模型提供統一的 API 存取層，使開發者無需維護多個供應商 SDK，即可整合新興的影片生成模型。

透過 CometAPI 使用 MiniMax H3 與其他影片生成 API 的工作流程相同：

步驟 1：取得 CometAPI API 金鑰

在 CometAPI 註冊帳號。
前往 API 控制台。
建立 API 金鑰。
使用生成的金鑰進行驗證。

示例：

Authorization: Bearer YOUR_COMETAPI_API_KEY

步驟 2：發送 MiniMax H3 影片生成請求

MiniMax 風格的影片生成 API 通常採用非同步任務架構：

提交生成請求。
接收 task_id。
查詢生成狀態。
取得生成的影片檔案。

MiniMax 官方影片 API 亦遵循此工作流程模式。

請參考 MiniMax H3 API 章節以取得示例請求的詳細資訊。

步驟 3：查詢影片生成狀態

提交任務後：

{
  "task_id": "xxxxxxxx",
  "status": "processing"
}

輪詢任務狀態直至完成。

成功回應：

{
  "status": "success",
  "file_id": "video_xxxxx"
}

步驟 4：取得生成的影片

可透過回傳的檔案 ID 存取完成的影片。

為何透過 CometAPI 使用 MiniMax H3 API？

1. 統一存取多個 AI 影片模型

開發者可與其他影片模型一同整合 MiniMax H3：

Seedance
Kling
Sora
Veo
Runway

無需維護各自獨立的 API 實作。

2. 簡化 API 管理

無需處理：

不同的驗證系統
不同的請求格式
不同的 SDK

開發者只需使用單一 API 介面。

3. 更快速的模型切換

AI 影片品質快速演進。

CometAPI 使應用程式可在不重建整個生產管線的情況下，嘗試不同的生成模型。

4. 友善開發者的工作流程

典型應用：

AI 影片 SaaS 平台
行銷自動化工具
電商內容生成器
AI 電影製作工具
社群媒體影片生成器

常見問題

定價

先參考上方的單次執行預估,再查看完整的 CometAPI 與官方價格比較。

5 秒測試

$0.5

預估 CometAPI 使用費用

10 秒測試

$1.00

預估 CometAPI 使用費用

15 秒測試

$1.50

預估 CometAPI 使用費用

MiniMax H3 的定價

Resolution	Comet Price (USD / Second)
768p	Per Second: $0.08
2K	Per Second: $0.13

API

複製可用的端點與程式碼範例,需要完整參數時再開啟完整 API 參考文件。

一個 API,直接對接正式環境模型

只需驗證一次,即可呼叫模型端點,並在各供應商間維持一致的計費與監控流程。

POST/v1/videosGET/v1/videos/{task_id}/contentGET/v1/videos/{task_id}

MiniMax H3 的範例程式碼和 API

存取完整的範例程式碼和 API 資源，以簡化您的 MiniMax H3 整合流程。我們詳盡的文件提供逐步指引，協助您在專案中充分發揮 MiniMax H3 的潛力。

POST

/v1/videos

GET

/v1/videos/{task_id}/content

GET

/v1/videos/{task_id}

#!/usr/bin/env bash
set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

cURL Code Example

#!/usr/bin/env bash
set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

Python Code Example

import os
import time
from pathlib import Path

import requests


api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}


def get(path: str, timeout: int) -> requests.Response:
    for attempt in range(3):
        try:
            response = requests.get(
                f"{base_url}{path}", headers=headers, timeout=timeout
            )
            response.raise_for_status()
            return response
        except requests.RequestException:
            if attempt == 2:
                raise
            time.sleep(2)
    raise RuntimeError("unreachable")

# 1. Create the task.
form = {
    "model": (None, "minimax-h3"),
    "prompt": (
        None,
        "A cinematic view of clouds moving over green mountains, "
        "locked camera, no text.",
    ),
    "seconds": (None, "5"),
    "size": (None, "1344x768"),
}
if image_url := os.getenv("MINIMAX_H3_IMAGE_URL"):
    form["images"] = (None, image_url)

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files=form,
    timeout=60,
)
response.raise_for_status()
task_id = response.json()["id"]
print(f"Task: {task_id}")

# 2. Poll until the task finishes.
while True:
    response = get(f"/v1/videos/{task_id}", timeout=30)
    task = response.json()
    status = task["status"]
    print(f"Status: {status}")
    if status == "failed":
        raise RuntimeError(task)
    if status == "completed":
        break
    time.sleep(10)

# 3. Download the completed video.
response = get(f"/v1/videos/{task_id}/content", timeout=300)
output = Path(f"{task_id}.mp4")
output.write_bytes(response.content)
print(f"Saved: {output}")

JavaScript Code Example

import fs from "node:fs";

const apiKey = process.env.COMETAPI_KEY;
const baseUrl = "https://api.cometapi.com";
const headers = { Authorization: `Bearer ${apiKey}` };
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function get(path) {
  for (let attempt = 0; attempt < 3; attempt += 1) {
    try {
      const result = await fetch(`${baseUrl}${path}`, { headers });
      if (!result.ok) throw new Error(`${result.status} ${await result.text()}`);
      return result;
    } catch (error) {
      if (attempt === 2) throw error;
      await sleep(2000);
    }
  }
  throw new Error("unreachable");
}

// 1. Create the task.
const form = new FormData();
form.append("model", "minimax-h3");
form.append(
  "prompt",
  "A cinematic view of clouds moving over green mountains, locked camera, no text.",
);
form.append("seconds", "5");
form.append("size", "1344x768");
if (process.env.MINIMAX_H3_IMAGE_URL) {
  form.append("images", process.env.MINIMAX_H3_IMAGE_URL);
}

let response = await fetch(`${baseUrl}/v1/videos`, {
  method: "POST",
  headers,
  body: form,
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const taskId = (await response.json()).id;
console.log(`Task: ${taskId}`);

// 2. Poll until the task finishes.
while (true) {
  response = await get(`/v1/videos/${taskId}`);
  const task = await response.json();
  console.log(`Status: ${task.status}`);
  if (task.status === "failed") throw new Error(JSON.stringify(task));
  if (task.status === "completed") break;
  await sleep(10000);
}

// 3. Download the completed video.
response = await get(`/v1/videos/${taskId}/content`);
const output = `${taskId}.mp4`;
fs.writeFileSync(output, Buffer.from(await response.arrayBuffer()));
console.log(`Saved: ${output}`);