動画公式パートナー

Hailuo 03 (MiniMax H3) API

MiniMax H3 で、音声が同期した 768p / ネイティブ 2K 動画を1つの統合 API から生成。画像・クリップ・音声サンプルをリファレンスとして渡せ、課金は出力の秒単位。非同期ジョブと Webhook に対応し、MiniMax の個別アカウントの管理は不要です。

APIキーを取得ドキュメントを読む

2K
最大解像度: 15s
最大クリップ長: ~285s
平均生成時間: 10 credits/s
最低価格

動画 · サンプル

プレイグラウンド

Hailuo 03 (MiniMax H3)をここで試す。

model: hailuo-03

プロンプト

アスペクト比長さ Resolution

メディア入力

Reference image End image Upgrade 768p clip to 2K Reference images Reference videos Reference audio

推定コスト 80–128 クレジット · $0.80–$1.28 Studioで生成

出力

出力はここに表示されます。生成を押すとStudioでこのリクエストが実行されます。

料金

シンプルな秒単位課金。

10–16 クレジット/出力1秒あたり ≈ $0.10–$0.16

料金は選択する解像度とオプションによって異なります。

9秒のクリップは90–144クレジット（≈ $0.90–$1.44）です。

成功した生成にのみ課金されます。失敗したジョブは自動的に返金されます。
Apiframeの全モデルでひとつのクレジット残高を共有。モデルごとのプランはありません。
無料クレジットで開始。サブスクリプションは不要です。
大きなプランにはボリュームディスカウントがあります。

プランとクレジットパックを見る

スペック

ひと目でわかる。

プロバイダー MiniMax

モデルID hailuo-03

アスペクト比 16:9, 21:9, 4:3, 1:1, 3:4, 9:16, auto

解像度 768p, 2K

長さ 4秒, 5秒, 6秒, 7秒, 8秒, 9秒, 10秒, 11秒, 12秒, 13秒, 14秒, 15秒

画像入力対応

音声対応

平均時間 ~285秒

クイックスタート

Hailuo 03 (MiniMax H3) APIの呼び出し方。

APIキーを添えてPOST /v2/videos/generateリクエストをひとつ送るだけ。呼び出しはポーリング可能なjobIdを返します。webhook_urlを渡せば、結果は完成と同時にプッシュされます。

hailuo-03を別のモデルに替えても、他は何も変わりません。

APIキーを取得ドキュメントを読む

generate.js

const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "hailuo-03",
    "hailuoParams": {
      "resolution": "2K",
      "image": "https://example.com/input.jpg",
      "end_image": "https://example.com/input.jpg",
      "base_video": "https://example.com/input.jpg"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "hailuo-03",
        "hailuoParams": {
            "resolution": "2K",
            "image": "https://example.com/input.jpg",
            "end_image": "https://example.com/input.jpg",
            "base_video": "https://example.com/input.jpg"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "hailuo-03",
        "hailuoParams": {
            "resolution": "2K",
            "image": "https://example.com/input.jpg",
            "end_image": "https://example.com/input.jpg",
            "base_video": "https://example.com/input.jpg"
        }
    }'

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

入力スキーマ

Hailuo 03 (MiniMax H3)が受け付けるすべてのフィールドと型、デフォルト値。完全なリファレンスはドキュメントにあります。

フィールド	型	説明
prompt 必須	string	生成する内容のテキスト説明。
model 必須	string	このエンドポイントのモデル識別子。デフォルト:"hailuo-03" · "hailuo-03"
hailuoParams.resolution	string	Resolution デフォルト:"2K" · "2K", "768p"
hailuoParams.image	string (URL)	Use a still as the first frame.
hailuoParams.end_image	string (URL)	Optional last frame to control the ending.
hailuoParams.base_video	string (URL)	A 768p Hailuo 03 clip to regenerate at 2K. Output is always 2K.
hailuoParams.reference_images	string[] (URLs)	First 5 are included; extra images are billed per image.
hailuoParams.reference_videos	string[] (URLs)	15s total across all clips. Billed per second, like the output.
hailuoParams.reference_audios	string[] (URLs)	Voice timbre reference. Needs at least one reference image or video.