I2V 01 Directorは、カメラコマンドが文書化されたMiniMaxの画像から動画を作る版です。渡された画像が最初のフレームを定め、プロンプトが目に見える動作とカメラの両方を指示します。既存の構図に、単に未指定の動きを付けるのではなく、特定の接近、見せ方、追従する動き、制御した固定視点が必要な場合に役立ちます。
画像を、意図したショットの始まりとして用意します。何かを見せる場合は、被写体と、カメラが明らかにする環境の部分を示してください。近くまで接近する場合は、フレーミングの変化が分かるよう、十分な周囲の空間から始めます。特に製品の形やキャラクターの外見を認識できる状態に保つ必要がある場合は、動き始める前に被写体の重要な特徴が見えるかを確かめてください。
開発元は、20 MB未満、短辺が300ピクセルを超え、縦横比が2:5から5:2のJPG、JPEG、PNG、WebP参照画像を受け付けます。開発元のワークフローでは、アクセスできる画像URLや符号化された画像データで最初のフレームを指定できます。後の修正で、再作成した近似画像ではなく同じ構図を使えるよう、元の参照画像を保持してください。
プロンプトは最大2,000文字に対応し、名前を持つ十五のカメラコマンドを含みます。Truckはカメラを水平に移動し、panは水平方向を変え、pedestalは垂直に移動し、tiltは垂直方向を変えます。Push、pull、zoomはそれぞれ異なる接近や後退を行い、tracking、shake、固定ショットはその他のカメラの意図を扱います。動きを指定するときは、文書化されたコマンドの綴りを使ってください。
説明の中で動きを起こしたい位置に、角括弧でコマンドを置きます。同じ括弧の中の複数のコマンドは同時の動きを、続く位置のコマンドは一連の動きを指示します。開発元は、組み合わせる動きを最大三つとすることを推奨しています。被写体へ単純にpushで近づく方が、同じ短いショットで複数の動きを競合させるより、詳細を明確に伝えられる場合があります。
被写体の動きは、カメラの動きと別に説明します。人がドアへ歩くこととカメラがその人を追うことは、視覚的な効果が異なる二つの指示です。接近中に顔を見える状態に保つ、被写体がフレームを横切る間はカメラを固定するなど、求める関係を指定してください。生成する動作に有用な到達点を与えるため、最後の構図を特定します。
開発元の旧来の画像から動画の表では、この版の既定値を720Pとし、十秒の選択肢は記載していません。自動プロンプト最適化は既定で有効で、文章の指示をより細かく制御するために無効にできます。ショットを比べるときは、言い回しや解釈の変化が生成の記録に表れるよう、その設定を原画像とカメラの指示とともに保持してください。
クリップ全体で、求めたカメラの軌道、被写体の連続性、重要な詳細のフレーミングを確認します。pushやpanで意図した情報が見え、最後の視点に次の編集のための空間が十分あるかを調べてください。完成した動画を、正確なプロンプト、原画像、設定とともに保存します。修正では、観察した問題の原因になったカメラの方向、タイミング、被写体の動作を変え、同じショットの計画と照らして結果を比較してください。
", "aboutText": "I2V 01 Directorは、カメラコマンドが文書化されたMiniMaxの画像から動画を作る版です。渡された画像が最初のフレームを定め、プロンプトが目に見える動作とカメラの両方を指示します。既存の構図に、単に未指定の動きを付けるのではなく、特定の接近、見せ方、追従する動き、制御した固定視点が必要な場合に役立ちます。\n\n画像を、意図したショットの始まりとして用意します。何かを見せる場合は、被写体と、カメラが明らかにする環境の部分を示してください。近くまで接近する場合は、フレーミングの変化が分かるよう、十分な周囲の空間から始めます。特に製品の形やキャラクターの外見を認識できる状態に保つ必要がある場合は、動き始める前に被写体の重要な特徴が見えるかを確かめてください。\n\n開発元は、20 MB未満、短辺が300ピクセルを超え、縦横比が2:5から5:2のJPG、JPEG、PNG、WebP参照画像を受け付けます。開発元のワークフローでは、アクセスできる画像URLや符号化された画像データで最初のフレームを指定できます。後の修正で、再作成した近似画像ではなく同じ構図を使えるよう、元の参照画像を保持してください。\n\nプロンプトは最大2,000文字に対応し、名前を持つ十五のカメラコマンドを含みます。Truckはカメラを水平に移動し、panは水平方向を変え、pedestalは垂直に移動し、tiltは垂直方向を変えます。Push、pull、zoomはそれぞれ異なる接近や後退を行い、tracking、shake、固定ショットはその他のカメラの意図を扱います。動きを指定するときは、文書化されたコマンドの綴りを使ってください。\n\n説明の中で動きを起こしたい位置に、角括弧でコマンドを置きます。同じ括弧の中の複数のコマンドは同時の動きを、続く位置のコマンドは一連の動きを指示します。開発元は、組み合わせる動きを最大三つとすることを推奨しています。被写体へ単純にpushで近づく方が、同じ短いショットで複数の動きを競合させるより、詳細を明確に伝えられる場合があります。\n\n被写体の動きは、カメラの動きと別に説明します。人がドアへ歩くこととカメラがその人を追うことは、視覚的な効果が異なる二つの指示です。接近中に顔を見える状態に保つ、被写体がフレームを横切る間はカメラを固定するなど、求める関係を指定してください。生成する動作に有用な到達点を与えるため、最後の構図を特定します。\n\n開発元の旧来の画像から動画の表では、この版の既定値を720Pとし、十秒の選択肢は記載していません。自動プロンプト最適化は既定で有効で、文章の指示をより細かく制御するために無効にできます。ショットを比べるときは、言い回しや解釈の変化が生成の記録に表れるよう、その設定を原画像とカメラの指示とともに保持してください。\n\nクリップ全体で、求めたカメラの軌道、被写体の連続性、重要な詳細のフレーミングを確認します。pushやpanで意図した情報が見え、最後の視点に次の編集のための空間が十分あるかを調べてください。完成した動画を、正確なプロンプト、原画像、設定とともに保存します。修正では、観察した問題の原因になったカメラの方向、タイミング、被写体の動作を変え、同じショットの計画と照らして結果を比較してください。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "77278ca8447a300fe52ff74981ef05666dcb231aa0ab972f7e0ff5454ad3a1a5", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ja", "methods": [ { "html": "minimaxi-i2v-01-directorI2V 01 Directorは、プロンプトに明示したカメラの動きのコマンドで、最初のフレームの画像を動かします。渡された構図と、truck、pan、push、tilt、zoom、trackingや固定カメラの指示を組み合わせ、短いショットを計画できます。
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
I2V 01 Directorは、カメラコマンドが文書化されたMiniMaxの画像から動画を作る版です。渡された画像が最初のフレームを定め、プロンプトが目に見える動作とカメラの両方を指示します。既存の構図に、単に未指定の動きを付けるのではなく、特定の接近、見せ方、追従する動き、制御した固定視点が必要な場合に役立ちます。
画像を、意図したショットの始まりとして用意します。何かを見せる場合は、被写体と、カメラが明らかにする環境の部分を示してください。近くまで接近する場合は、フレーミングの変化が分かるよう、十分な周囲の空間から始めます。特に製品の形やキャラクターの外見を認識できる状態に保つ必要がある場合は、動き始める前に被写体の重要な特徴が見えるかを確かめてください。
開発元は、20 MB未満、短辺が300ピクセルを超え、縦横比が2:5から5:2のJPG、JPEG、PNG、WebP参照画像を受け付けます。開発元のワークフローでは、アクセスできる画像URLや符号化された画像データで最初のフレームを指定できます。後の修正で、再作成した近似画像ではなく同じ構図を使えるよう、元の参照画像を保持してください。
プロンプトは最大2,000文字に対応し、名前を持つ十五のカメラコマンドを含みます。Truckはカメラを水平に移動し、panは水平方向を変え、pedestalは垂直に移動し、tiltは垂直方向を変えます。Push、pull、zoomはそれぞれ異なる接近や後退を行い、tracking、shake、固定ショットはその他のカメラの意図を扱います。動きを指定するときは、文書化されたコマンドの綴りを使ってください。
説明の中で動きを起こしたい位置に、角括弧でコマンドを置きます。同じ括弧の中の複数のコマンドは同時の動きを、続く位置のコマンドは一連の動きを指示します。開発元は、組み合わせる動きを最大三つとすることを推奨しています。被写体へ単純にpushで近づく方が、同じ短いショットで複数の動きを競合させるより、詳細を明確に伝えられる場合があります。
被写体の動きは、カメラの動きと別に説明します。人がドアへ歩くこととカメラがその人を追うことは、視覚的な効果が異なる二つの指示です。接近中に顔を見える状態に保つ、被写体がフレームを横切る間はカメラを固定するなど、求める関係を指定してください。生成する動作に有用な到達点を与えるため、最後の構図を特定します。
開発元の旧来の画像から動画の表では、この版の既定値を720Pとし、十秒の選択肢は記載していません。自動プロンプト最適化は既定で有効で、文章の指示をより細かく制御するために無効にできます。ショットを比べるときは、言い回しや解釈の変化が生成の記録に表れるよう、その設定を原画像とカメラの指示とともに保持してください。
クリップ全体で、求めたカメラの軌道、被写体の連続性、重要な詳細のフレーミングを確認します。pushやpanで意図した情報が見え、最後の視点に次の編集のための空間が十分あるかを調べてください。完成した動画を、正確なプロンプト、原画像、設定とともに保存します。修正では、観察した問題の原因になったカメラの方向、タイミング、被写体の動作を変え、同じショットの計画と照らして結果を比較してください。
POST /v1/videostext, imagevideo| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 minimaxi-i2v-01-director 条件: 正確なAilootモデル指定子を使用してください。 | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 条件: シーンと動きを記述してください。 | デフォルト— |
フィールドend_image | 種類string | 要件任意 | 値と制限 条件: 終端フレームは、サポートされている画像入力モードでのみ適用されます。 | デフォルト— |
フィールドimage | 種類string or array<string> | 要件任意 | 値と制限 条件: 実際に外部から到達可能な画像URL、またはbase64画像文字列を使用してください。ここでは画像数の上限を断定しません。 | デフォルト— |
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, prompt |
パラメータoptional | 仕様end_image, image |
パラメータmaterial_types | 仕様text, image |
パラメータconditions | 仕様正確なAilootモデル指定子を使用してください。, シーンと動きを記述してください。, 終端フレームは、サポートされている画像入力モードでのみ適用されます。, 実際に外部から到達可能な画像URL、またはbase64画像文字列を使用してください。ここでは画像数の上限を断定しません。 |
メソッドのエイリアス: /v1/videos/generations
ライフサイクル: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 課金数量 | 料金 |
|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 課金数量— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定リクエストごと | 料金表— | 予測数量— | 課金数量リクエスト1件 | 料金 入力 · 比較専用の見積もり $1 リクエストあたり |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 課金数量— | 料金 出力 · 推定生成コスト · 比較専用の見積もり $1 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncat > request.json <<'JSON'\n{\n "model": "minimaxi-i2v-01-director",\n "prompt": "A cat is walking on grass.",\n "image": "YOUR_ACCESSIBLE_IMAGE_URL"\n}\nJSON\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Create once; retain id, polling_url, original task identifiers and every header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\\x89PNG\\r\\n\\x1a\\n" else "jpg" if raw[:3]==b"\\xff\\xd8\\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。
完全なレスポンスとヘッダー、元の識別子、実際のすべての出力、および使用量／会計の全フィールドを保持してください。一意の所有アセットをそれぞれ保存し、それを参照するすべての役割を保持してください。
返された公開タスクまたは操作のidと、すべてのヘッダーを保持してください。元のタスクだけを読み取ってください。unknownまたはresult_pending_checkであっても、別の作成を行うことは認められません。
| フィールド | 種類 |
|---|---|
フィールドid | 種類string |
フィールドpolling_url | 種類string |
フィールドprovider_task_id | 種類string |
フィールドtask_id | 種類string |
フィールドstatus | 種類string |
フィールドvideo_url | 種類string |
Ailoot Ultra minimaxi-i2v-01-director
/v1/videos/generations