Hailuo 動画生成 は何をしますか?
AceDataCloud の Hailuo(MiniMax)API を通じて AI 動画を生成します。
セットアップ: トークンの設定方法は 認証 を参照してください。
クイックスタート
curl -X POST https://api.acedata.cloud/hailuo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "generate", "prompt": "黄金時間に波を跳ねるイルカ", "model": "minimax-t2v"}'
非同期: 非同期タスクポーリング を参照してください。
POST /hailuo/tasksに{"id": "..."}を送信してポーリングします。
モデル
| モデル | タイプ | 最適用途 |
|---|---|---|
minimax-t2v | テキスト→動画 | テキスト説明から動画を作成 |
minimax-i2v | 画像→動画 | 静止画像を動画化 |
minimax-i2v-director | 画像→動画(ディレクター) | 画像からのアニメーションを精密に制御 |
ワークフロー
1. テキスト→動画
POST /hailuo/videos
{
"action": "generate",
"prompt": "草原で花が咲くタイムラプス",
"model": "minimax-t2v"
}
2. 画像→動画
静止画像を動画クリップに変換します。
POST /hailuo/videos
{
"action": "generate",
"prompt": "そよ風がシーンを吹き抜ける",
"model": "minimax-i2v",
"first_image_url": "https://example.com/landscape.jpg"
}
3. 画像→動画(ディレクターモード)
より精密なアニメーション制御。
POST /hailuo/videos
{
"action": "generate",
"prompt": "葉が優しく舞い落ちる中、カメラがゆっくりズームイン",
"model": "minimax-i2v-director",
"first_image_url": "https://example.com/scene.jpg"
}
パラメータ
| パラメータ | 必須 | 値 | 説明 |
|---|---|---|---|
action | はい | "generate" | アクションタイプ |
prompt | はい | 文字列 | 動画の説明 |
model | はい | "minimax-t2v", "minimax-i2v", "minimax-i2v-director" | モデル |
first_image_url | i2vの場合は必須 | 文字列 | ソース画像のURL(画像→動画の場合必須) |
callback_url | いいえ | 文字列 | 非同期コールバックURL |
注意点
first_image_urlはminimax-i2vおよびminimax-i2v-directorモデルで 必須 です。- ディレクターモード(
minimax-i2v-director)は、標準の i2v よりも細かいカメラ/モーション制御を提供します。 actionフィールドは現在"generate"のみをサポートしており、拡張や編集はできません。- モデルに関わらず、生成あたりの料金はフラットです。