メインコンテンツへスキップ
POST
https://api.apimart.ai
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "かわいい子猫が草原を走っている",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "かわいい子猫が草原を走っている",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
認証

​
Authorization
string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得：APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名固定値：MiniMax-Hailuo-2.3
​
prompt
string
必須
動画コンテンツの説明（最大2000文字）シーン、アクション、スタイルなどを詳しく記述すると、より良い生成結果が得られます。カメラワーク指令をサポートしています（下記のカメラワーク指令を参照）。例："かわいい子猫が草原を走っている"
​
duration
integer
デフォルト:"6"
動画の長さ（秒）オプション：
  • 6 - 6秒動画
  • 10 - 10秒動画
デフォルト：6
1080p制限：1080p解像度使用時は、6秒の長さのみサポート
​
resolution
string
デフォルト:"768p"
動画の解像度オプション：
  • 768p - 高解像度
  • 1080p - フルHD（6秒の長さのみサポート）
デフォルト：768p
​
first_frame_image
string
動画の先頭フレーム画像2つの形式をサポート：
  • 公開URL：https://example.com/start.jpg
  • Base64エンコード：data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
指定すると、この画像が動画の開始フレームとして使用されます
​
prompt_optimizer
boolean
デフォルト:"true"
プロンプトを自動最適化するかどうか有効にすると、システムがプロンプトを自動的に最適化し、より良い生成結果を得られますデフォルト：true
​
fast_pretreatment
boolean
デフォルト:"false"
プロンプト最適化時間を短縮するかどうか有効にすると処理速度が速くなりますが、最適化品質がわずかに影響を受ける場合がありますデフォルト：false
​
watermark
boolean
デフォルト:"false"
ウォーターマークを追加するかどうかデフォルト：false

​
解像度と長さの組み合わせ

解像度サポートされる長さ備考
768p6秒、10秒すべてサポート
1080p6秒10秒はサポートされません

​
カメラワーク指令

prompt 内で [指令] 構文を使用してカメラワークを制御できます。15種類の指令をサポート：
カテゴリ指令
パン[左移]（左パン）[右移]（右パン）
水平回転[左摇]（左回転）[右摇]（右回転）
プッシュ/プル[推进]（プッシュイン）[拉远]（プルアウト）
垂直移動[上升]（上昇）[下降]（下降）
垂直回転[上摇]（チルトアップ）[下摇]（チルトダウン）
ズーム[变焦推近]（ズームイン）[变焦拉远]（ズームアウト）
その他[晃动]（シェイク）[跟随]（フォロー）[固定]（固定）
使用例： 
{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]猫が庭を走り、カメラがゆっくりとクローズアップに寄る"
}

​
レスポンス

​
code
integer
レスポンスステータスコード、成功時は200
​
data
array
レスポンスデータ配列

​
使用シーン

​
シーン 1：テキストから動画を素早く生成

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "かわいい子猫が草原を走っている、晴れた日"
}

​
シーン 2：高品質 1080p 動画

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "都市の夜景、ネオンが点滅、車の流れ",
  "duration": 6,
  "resolution": "1080p",
  "prompt_optimizer": true,
  "watermark": false
}

​
シーン 3：先頭フレーム画像から動画生成

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "子猫がカメラに向かって走ってくる、微笑んでウインク",
  "first_frame_image": "https://example.com/cat.jpg",
  "duration": 6,
  "resolution": "1080p"
}

​
シーン 4：カメラワーク指令の使用

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]猫が庭を走り、カメラがゆっくりとクローズアップに寄る",
  "duration": 6,
  "resolution": "768p"
}

​
シーン 5：高速前処理モード

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "波がビーチに打ちつける、夕暮れ時",
  "duration": 10,
  "resolution": "768p",
  "prompt_optimizer": true,
  "fast_pretreatment": true
}
タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントで生成の進捗と結果を照会できます。