MiniMax H3 Highspeed 参照から動画
minimax/h3-highspeed/reference-to-video
768p、4–15 秒の動画を生成します。
サンプル
パラメータ
| 名前 | 型 | 既定 | 制約 | 説明 |
|---|---|---|---|---|
| prompt *プロンプト | textarea | — | ≤ 5000 chars | 生成したい動画のシーンや動き、相互作用を説明するテキストです。 |
| reference_images参照画像 | image_upload | — | image/* · 0–9 items | 参照画像 URL を最大 9 件まで指定できます。参照画像または参照動画を少なくとも 1 つ指定する必要があります。画像は各辺 256〜5760 ピクセル、縦横比は 0.4〜2.5 である必要があります。 |
| reference_audios参照音声 | audio_upload_group | — | audio/* · 0–3 items | 任意の WAV または MP3 の参照音声 URL を最大 3 件まで指定できます。各ファイルは最大 15 MB です。各クリップは 2〜15 秒、合計の最大長は 15 秒です。音声は自動でトリミングされず、単独では指定できません。 |
| aspect_ratioアスペクト比 | select | 16:9 | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | 出力動画のアスペクト比です。 |
| resolution解像度 | select | 768p | 768p | 出力動画の解像度です。 |
| duration長さ | select | 5 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | … | 出力動画の長さ(秒)です。 |
出力フィールド
| フィールド | 型 | 説明 |
|---|---|---|
| videos | array<string> |
API
統一 REST API でこのモデルを呼び出せます。API Keys ページでキーを取得してください。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-highspeed/reference-to-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "16:9",
"resolution": "768p",
"duration": 5
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-highspeed/reference-to-video",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "16:9",
"resolution": "768p",
"duration": 5
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-highspeed/reference-to-video", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "16:9",
"resolution": "768p",
"duration": 5
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);ドキュメント
MiniMax H3 Highspeed 参照から動画
768p、4–15 秒の動画を生成します。
入力
| Parameter | 必須 | 型・選択肢・初期値 |
|---|---|---|
prompt | 必須 | string; max 5000 characters. 生成したい動画のシーンや動き、相互作用を説明するテキストです。 |
reference_images | 任意 | array; max count: 9. 参照画像 URL を最大 9 件まで指定できます。参照画像または参照動画を少なくとも 1 つ指定する必要があります。画像は各辺 256〜5760 ピクセル、縦横比は 0.4〜2.5 である必要があります。 |
reference_videos | 任意 | array; max count: 3. 参照動画 URL を最大 3 件まで指定できます。各クリップは 2〜15 秒に調整され、合計の最大長は 15 秒です。長すぎるクリップはトリミングされ、短すぎるクリップは延長されます。MP4 または MOV に対応し、各ファイルは最大 50 MB、各辺 256〜5760 ピクセル、縦横比 0.4〜2.5、フレームレート 23.976〜60 FPS です。画像または動画を少なくとも 1 つ指定する必要があります。 |
reference_audios | 任意 | array; max count: 3. 任意の WAV または MP3 の参照音声 URL を最大 3 件まで指定できます。各ファイルは最大 15 MB です。各クリップは 2〜15 秒、合計の最大長は 15 秒です。音声は自動でトリミングされず、単独では指定できません。 |
aspect_ratio | 任意 | string; 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16; default: "16:9". 出力動画のアスペクト比です。 |
resolution | 任意 | string; 768p; default: "768p". 出力動画の解像度です。 |
duration | 任意 | integer; 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15; default: 5. 出力動画の長さ(秒)です。 |
現在の MaaS の制限に合わせ、Nami のプロンプトは最大 5000 文字です。必須プロンプトは空にできません。
参照画像または動画を最低 1 件指定します。音声のみは利用できません。最大で画像 9 枚、動画 3 件、音声 3 件。画像と動画フレームは各辺 256–5760 ピクセル、縦横比 0.4–2.5。動画は MP4/MOV、各 50 MB 以下、23.976–60 FPS。動画は各 2–15 秒、合計 15 秒以下に調整されます。参照音声は WAV/MP3、各 15 MB 以下、各 2–15 秒、合計 15 秒以下。音声は自動で切り詰められません。
標準料金
1 USD = 100 クレジット。アカウント割引は別途適用されます。
768p の出力は 1 秒 $0.06(6 クレジット)。長さは整数 4–15 秒、初期値は 5 秒です。
参照動画料金:$0.06 × ceil(min(各参照動画を最低 2 秒として合計した秒数, 15))。最初の 5 枚の参照画像は無料、追加は 1 枚 $0.03(3 クレジット)。参照音声は無料です。
API の利用
アクセス可能な素材 URL を指定してください。一度送信した後、task_uuid で completed または failed まで照会します。成功時の output.videos は動画 URL の配列です。
POST https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-highspeed/reference-to-video
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"resolution": "768p",
"prompt": "A colorful scene with gentle natural movement.",
"duration": 5,
"reference_images": [
"https://example.com/subject.png"
],
"aspect_ratio": "16:9"
}
}
GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
関連モデル
xAI Grok Imagine Video v1.5 参照画像から動画
プロンプトと1-7枚の参照画像から1-15秒の動画を生成します。480pと720pに対応しています。
Vidu Q4 Preview 参照から動画
プロンプトから3〜16秒の動画を生成します。参照画像は最大15枚、参照音声は最大3件まで任意で指定でき、アスペクト比選択、音声生成、540p〜4kに対応します。
MiniMax H3 参照画像から動画生成
MiniMax H3 Reference to Video は、自然言語のプロンプトと画像・動画・音声を含むマルチモーダルな参照情報から、一貫性のある 2K 動画を生成します。被写体の一貫性、モーション、タイミング、ビジュアルスタイル、シーンの連続性をコントロールできます。すぐに使える REST 推論 API を提供し、高性能・コールドスタートなし・手頃な価格で利用できます。
MiniMax H3 Lite 参照動画生成
ネイティブ音声付き動画を生成。4–15 秒、480p または 768p に対応。
MiniMax H3 Singularity 参照動画生成 LoRA
ネイティブステレオ音声付き動画。3–15 秒、4 段階の解像度に対応。カスタム LoRA 対応。
MiniMax H3 Singularity 参照動画生成
ネイティブステレオ音声付き動画。3–15 秒、4 段階の解像度に対応。
Kling 4.0 参照から動画
画像・動画・音声を参照して3〜30秒の720pまたは1080p動画を生成します。プロンプトで素材を指定できます。
Gemini Omni Flash 参照画像から動画生成 API
Gemini Omni Flash 参照画像から動画生成は、1枚以上の参照画像とテキストのプロンプトから、音声が同期した短い AI 動画を生成します。視覚的な一貫性を保ちながら、提供された参照内容に従ってガイド付きのマルチモーダル動画生成を行います。すぐに使える REST 推論 API、高性能、コールドスタートなし、手頃な価格。