MiniMax H3 是否為開發者提供 API？

MiniMax 提供影片生成 API，支援非同步任務建立、狀態查詢與檔案取得的流程。H3 專屬 API 的可用性取決於提供方的逐步推出時程。

MiniMax H3 是否能進行圖像轉影片生成？

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

MiniMax H3 是否支援文字轉影片生成？

是的。MiniMax H3 支援以文字、圖像、影片與音訊作為輸入的多模態影片生成。它可依照自然語言指令生成影片，並在視覺與音訊元素之間保持一致性。

開發者能否透過 CometAPI 整合 MiniMax H3？

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

MiniMax H3 是否適合商業影片製作？

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

MiniMax H3 與 Sora 2 及 Seedance 2.0 相比如何？

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

MiniMax H3 能生成多長以及何種解析度的影片？

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

MiniMax H3 與傳統 AI 影片模型有何不同？

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

MiniMax

可使用熱門

minimax-h3

MiniMax H3 API

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

起始價格

$0.064 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

Aug 7, 2026

MiniMax

互動測試

透過實際請求試用 MiniMax H3,檢視參數並在整合 API 前驗證輸出結果。

定價

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

5 秒測試

$0.3200

預估 CometAPI 使用成本

10 秒測試

$0.6400

預估 CometAPI 使用成本

15 秒測試

$0.9600

預估 CometAPI 使用成本

最低收費透明度此原型不假設隱藏的每次請求最低費用。如果適用生產計費下限或最低充值，則必須在購買前顯示並包含在每個預算估算中。

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

模型簡介

穩定的模型身分可供搜尋與評估使用，搭配可能變動的即時目錄資料，無需重寫頁面的核心 SEO 結構。

穩定識別

MiniMax H3 是什麼？

即使價格與限制有所變動，標準模型身分仍保持穩定。

即時模型資料

目前目錄快照

可用性

可用

起始價格

$0.064 / 秒

上下文

查看功能

目錄日期

Aug 7, 2026

概覽

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

MiniMax H3 的技術規格

Item	MiniMax H3
Model family	MiniMax H Series
Model type	多模態影片生成模型
Provider	MiniMax
Input modalities	文字、圖片、影片、音訊
Output	帶音訊的生成影片
Maximum video resolution	最高至 2K
Maximum duration	最長 15 秒
Audio generation	原生立體聲
Video capabilities	文字轉影片、圖片轉影片、影片編輯、動作遷移
Weight availability	計劃開放權重釋出
Main applications	廣告、電商、產品設計、遊戲、創意製作

Source: 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 提供統一的 API 存取層，使開發者能整合新興影片生成模型，而無需維護多個供應商 SDK。

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

步驟 1：取得 CometAPI API Key

在 CometAPI 上註冊帳戶。
前往 API Console。
建立 API 金鑰。
使用所產生的金鑰進行驗證。

Example:

Authorization: Bearer YOUR_COMETAPI_API_KEY

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

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

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

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

Example request refer to the MiniMax H3 API section for details.

步驟 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 電影製作工具
社群媒體影片生成器

常見問題

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}

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

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

Wan 3.0 Prime

Wan 3.0 Prime 是 Alibaba Cloud Model Studio 中 Wan 3.0 影片生成模型的速度優化版本。

查看模型

Aliyun

Wan3.0

從快速驗證到電影級輸出，計費以所生成影片的片長為基準、選擇合適的解析度，並將每次生成轉化為有規劃的創意投資的活動規則

查看模型

Aliyun

Wan2.6

Wan2.6 是一款專為穩定且高效的影片合成而設計的影片生成模型。它為一般影片製作任務提供可靠的視覺品質與流暢的動態生成。

查看模型

Flux

Flux 3

FLUX 3 - 真實世界模型：邁向以多模態流模型作為視覺智能的骨幹。

查看模型

Aliyun

Happy Horse 1.1

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

查看模型

Aliyun

Wan2.7

Wan2.7 是一款面向高品質視覺合成並提升動作一致性的影片生成模型。適用於電影級內容創作與專業影片製作工作流程。

查看模型

服務可用性

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

服務可用性

過去 30 天的請求成功率，反映每個模型供應商的可靠性。CometAPI 全天候即時監控所有已連接的供應商。

Respond

251868msAvg. Response

Uptime

82.4%Avg. Uptime

版本

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

minimax-h3

minimax-h3-max

更新

持續追蹤 MiniMax H3 重要的可用性、價格與功能變動，同時保留穩定的模型頁面。

模型變更記錄

一個隨時間日益完善的頁面。

發布說明、價格變動、基準測試更新與遷移指南都會在此累積，而標準 URL 維持不變。

Aug 7, 2026

API 可用性已確認

MiniMax H3 可透過 CometAPI 模型目錄和 API 文件使用。

目前

即時資料

價格與限制已從目錄同步

價格、上下文、可用性和限制會被視為動態屬性，而不是嵌入頁面標題或模型識別中。

Jul 31, 2026

已建立永久模型實體

供應商與模型 slug 構成持久的規範 URL；未來的內容和資料更新將保留在此頁面。

持續探索

比較模型,繼續你的研究

MiniMax

可使用熱門

minimax-h3

MiniMax H3 API

起始價格

$0.064 / 秒

按使用量計費

API 健康狀態

可使用

正式環境端點

回應時間

支援非同步

實測 API 回應時間

發布時間

Aug 7, 2026

MiniMax

互動測試

透過實際請求試用 MiniMax H3,檢視參數並在整合 API 前驗證輸出結果。

定價

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

5 秒測試

$0.3200

預估 CometAPI 使用成本

10 秒測試

$0.6400

預估 CometAPI 使用成本

15 秒測試

$0.9600

預估 CometAPI 使用成本

最低收費透明度此原型不假設隱藏的每次請求最低費用。如果適用生產計費下限或最低充值，則必須在購買前顯示並包含在每個預算估算中。

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

模型簡介

穩定的模型身分可供搜尋與評估使用，搭配可能變動的即時目錄資料，無需重寫頁面的核心 SEO 結構。

穩定識別

MiniMax H3 是什麼？

即使價格與限制有所變動，標準模型身分仍保持穩定。

即時模型資料

目前目錄快照

可用性

可用

起始價格

$0.064 / 秒

上下文

查看功能

目錄日期

Aug 7, 2026

概覽

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

MiniMax H3 的技術規格

Item	MiniMax H3
Model family	MiniMax H Series
Model type	多模態影片生成模型
Provider	MiniMax
Input modalities	文字、圖片、影片、音訊
Output	帶音訊的生成影片
Maximum video resolution	最高至 2K
Maximum duration	最長 15 秒
Audio generation	原生立體聲
Video capabilities	文字轉影片、圖片轉影片、影片編輯、動作遷移
Weight availability	計劃開放權重釋出
Main applications	廣告、電商、產品設計、遊戲、創意製作

Source: MiniMax 公告與技術說明.

什麼是 MiniMax H3？

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 提供統一的 API 存取層，使開發者能整合新興影片生成模型，而無需維護多個供應商 SDK。

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

步驟 1：取得 CometAPI API Key

在 CometAPI 上註冊帳戶。
前往 API Console。
建立 API 金鑰。
使用所產生的金鑰進行驗證。

Example:

Authorization: Bearer YOUR_COMETAPI_API_KEY

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

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

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

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

Example request refer to the MiniMax H3 API section for details.

步驟 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 電影製作工具
社群媒體影片生成器

常見問題

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}

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

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}`);