MiniMax H3 Lite 参照動画生成
minimax/h3-lite/reference-to-video
ネイティブ音声付き動画を生成。4–15 秒、480p または 768p に対応。
サンプル
パラメータ
| 名前 | 型 | 既定 | 制約 | 説明 |
|---|---|---|---|---|
| prompt *プロンプト | textarea | — | ≤ 5000 chars | 生成したい動画のシーンや動き、相互作用を説明するテキストです。 |
| reference_images参照画像 | image_upload | — | image/* · 0–9 items | 参照画像 URL を最大 9 件まで指定できます。少なくとも 1 枚の参照画像または 1 本の参照動画が必要です。画像は各辺 256〜5760 ピクセル、幅と高さの比率は 0.4〜2.5 である必要があります。 |
| reference_audios参照音声 | video_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 | 480p | 出力動画の解像度です。 |
| 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-lite/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-lite/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-lite/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 Lite 参照動画生成
ネイティブ音声付き動画を生成。4–15 秒、480p または 768p に対応。
入力
| Parameter | 必須 | 型・制限・初期値 |
|---|---|---|
prompt | Yes | string; 1–5000 characters. 生成したい動画のシーンや動き、相互作用を説明するテキストです。 |
reference_images | No | array; max 9. 参照画像 URL を最大 9 件まで指定できます。少なくとも 1 枚の参照画像または 1 本の参照動画が必要です。画像は各辺 256〜5760 ピクセル、幅と高さの比率は 0.4〜2.5 である必要があります。 |
reference_videos | No | array; max 3. 参照動画 URL を最大 3 件まで指定できます。各クリップは 2〜15 秒に調整され、合計の最大長は 15 秒です。長いクリップはトリミングされ、短いクリップは延長されます。MP4 または MOV を使用し、各ファイルは最大 50 MB、各辺 256〜5760 ピクセル、幅と高さの比率は 0.4〜2.5、フレームレートは 23.976〜60 FPS に対応します。少なくとも 1 枚の画像または 1 本の動画が必要です。 |
reference_audios | No | array; max 3. 任意の WAV または MP3 の参照音声 URL を最大 3 件まで指定できます。各ファイルは最大 15 MB です。各クリップは 2〜15 秒で、合計の最大長は 15 秒です。音声は自動でトリミングされず、単独では指定できません。 |
aspect_ratio | No | string; 21:9, 16:9, 4:3, 1:1, 3:4, 9:16; default: 16:9. 出力動画のアスペクト比です。 |
resolution | No | string; 768p, 480p; default: 768p. 出力動画の解像度です。 |
duration | No | integer; 4–15; 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15; default: 5. 出力動画の長さ(秒)。 |
プロンプトは空にできません。現在の MaaS 入力制限に合わせ、本 API は最大 5000 文字です(WaveSpeed 自体は最大 7000 文字)。
参照画像または動画を最低 1 件指定してください。音声のみは使用できません。画像は各辺 256–5760 ピクセル、縦横比 0.4–2.5。動画は MP4/MOV、各 50 MB 以下、23.976–60 FPS、各辺 256–5760 ピクセル、縦横比 0.4–2.5。参照音声は WAV/MP3、各 15 MB 以下、各 2–15 秒、合計 15 秒以下です。音声は自動トリミングされません。
標準料金
| Resolution | USD / second | Credits / second |
|---|---|---|
| 480p | $0.025 | 2.5 |
| 768p | $0.04 | 4 |
アカウント割引は別途適用されます。1 USD = 100 クレジット。生成音声の追加料金はありません。
現在の料金 = 秒単価 × (出力秒数 + ceil(min(各参照動画を最低 2 秒として合計した秒数, 15))) + $0.02 × max(参照画像数 − 5, 0)。最初の 5 枚の参照画像と参照音声は無料です。
API の例
URL をアップロード済み素材に置き換えてください。送信後は task_uuid で completed または failed まで確認します。成功時の output.videos は動画 URL 配列です。image と last_image は 1 要素の配列を受け取り、上流の単一 URL に変換されます。
POST https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-lite/reference-to-video
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"prompt": "Colorful shapes move gently through the scene.",
"duration": 5,
"resolution": "768p",
"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 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、高性能、コールドスタートなし、手頃な価格。
Seedance 2.0 Mini 参照生成動画
Seedance 2.0 Mini Reference-to-Video(リファレンス画像指定動画生成)は、ByteDance(バイトダンス)が開発した、シネマティックなマルチショット動画の作成に最適な、高速かつ低コストな動画生成モデルです。参考画像とテキストプロンプトを高度に融合させ、ストーリー性豊かな動画セグメントを生成します。AIによる柔軟なカメラワーク制御に対応しているだけでなく、異なるシーン間でのキャラクターの同一性を維持するという課題もクリアしています。480Pから4Kまでのマルチ解像度出力、4〜15秒の動画長、そして自由なアスペクト比をサポート。すぐに使えるREST推論APIが提供されており、コールドスタートなしの圧倒的なパフォーマンスを圧倒的なコストパフォーマンスで実現します。