Alibaba: Wan 3.0 Prime
Alibaba Wan 3.0 Primeは、速度を重視して最適化したWan 3.0動画モデルです。メーカーのプロファイルは、テキスト、開始フレーム、開始・終了フレーム、マルチモーダル参照からの生成と統合音声に対応します。480p、720p、1080pで、30fpsの2〜30秒のMP4を出力し、適応型の構図と編集フローを備えます。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Alibaba Wan 3.0 Primeは、Wan 3.0動画シリーズの高速版です。メーカーはwan3.0-video-primeという名前で、標準のWan 3.0と同じ統合型のタスク区分を文書化し、速度をこの版の特徴としています。文章による指示、開始画像、映像や音声の参照資料、元の動画を使って、音付きのクリップを導けます。商品シーン、短い物語、静止画のアニメーション、既存ショットへの具体的な修正などを作成できます。
テキストから動画を作る場合は、被写体、場面、動き、カメラ、映像表現、音を説明します。3.0のガイドは単一ショットと、ショットのラベルや時間範囲を付けた絵コンテに対応し、1ショットをおよそ4〜6秒にすることを勧めています。商品クリップなら、机の上のバッグを安定した広い画角で見せ、素材の細部に寄り、最後は短いせりふの間に構図を固定するといった流れを指定できます。シーケンスの目的を一つに絞り、カメラ、テンポ、商品の同一性が一貫しているか確認してください。
最初のフレームを指定する生成では、提供画像が冒頭を決め、プロンプトが動きとカメラワークを説明します。最初と最後のフレームを指定する生成では、両端の画像を提供して、その間の遷移を要求します。同じ場面に属する両端の画像と、意図する出力に合う形状を用意してください。メーカーは画像を使うタスクに適応型フレーミングを推奨しています。両端フレームのモードと個別の参照モードでは、素材の組み合わせ規則が異なります。一つのリクエストで、最初または最後のフレームを参照画像、参照動画、参照音声と混在させることはできません。
参照モードでは、画像を最大10枚、動画を5本、音声を5本、合計20点までのマルチモーダル参照素材として受け付けます。文書化されたファイルごとの上限は、参照画像が20 MB、動画が100 MB、音声が15 MBです。参照動画の合計時間は最大15秒で、参照音声にも別枠で合計15秒の上限があります。各素材の役割を明示し、Image 1、Video 1、Audio 1のように種類ごとの番号を使ってください。人物、商品、カメラの動き、声を、区別のない参照素材として扱わないでください。
メーカーは文書1件または公開ウェブページ1件の参照にも対応し、ほかの参照素材と併用できます。ファイルとウェブリンクは同時に指定できず、参照先にはログインなしでアクセスできる必要があります。文書を基にした場面では、商品の情報や物語の内容を文脈として用い、見た目は映像の参照資料で定められます。クリップに実際に反映させる資料を用意し、重要な要素を明示してください。見栄えがよくても内容が変わった表現をそのまま受け入れず、生成された場面の事実に関わる細部や文字を元資料と照合してください。
映像とともに、会話、環境音、効果音、BGMが生成されます。発話内容、話者の特徴、話し方、場面の中での音の位置付けを説明してください。ガイドでは音声が既定で有効になり、無音動画を指定する制御も文書化されています。会話では、各話者に固有の見た目と声の手掛かりを与え、やり取りに十分な時間を設けてください。実際の言葉、話者の割り当て、効果音と画面上の動作の関係を聴いて確認します。統合された音声も場面の一部なので、映像と同じように確認する必要があります。
メーカーの統合型ガイドは、参照動画の編集と延長も文書化しています。編集の指示では、追加、削除、置換する要素と、残す特徴を明示します。延長の指示では、既存クリップの前、後、またはその周囲に加える内容を説明します。これらのワークフローでは適応型フレーミングとスマート尺を使います。動画を入力する場合、文書化された入力と出力の動画時間の合計は30秒を超えてはいけません。元の区間と意図する変更を明確にし、魅力的な1フレームだけで判断せず、つなぎ目、維持された被写体、音を確認してください。
文書化された出力は30 fpsのMP4で、解像度は480p、720p、1080p、新規生成の長さは2〜30秒です。スマート尺ではモデルが適した長さを選択します。正方形、横長、縦長の画角に対応し、適応型フレーミングは提供素材に合わせます。メーカーは生成をジョブとして処理し、完成動画の保存先を返します。ガイドでは、その保存先は24時間有効とされています。編集やシーケンスを準備するときは実際のクリップと制作指示を保存し、利用前に成果物全体を確認してください。
Primeと標準のWan 3.0は、文書化されたモードと準備の構成を共有します。Primeは速度を最適化した選択肢で、固定の完了時間を保証するものではありません。以前のWan 2.7と2.6には独自の長さ、参照、出力の規則があり、その上限がこの3.0版を定めるわけではありません。確認では、物体や登場人物の連続性、両端の構図、要求した編集、会話、元資料に依存する細部を見ます。次の修正を具体的に絞り、うまくできた要素を保ちながら、見つかった問題を直してください。
Ailoot Ultra · 動画 POST /v1/videos alibaba/wan-3.0-prime
alibaba/wan-3.0-primeはじめに
Alibaba Wan 3.0 Primeは、速度を重視して最適化したWan 3.0動画モデルです。メーカーのプロファイルは、テキスト、開始フレーム、開始・終了フレーム、マルチモーダル参照からの生成と統合音声に対応します。480p、720p、1080pで、30fpsの2〜30秒のMP4を出力し、適応型の構図と編集フローを備えます。
- 対応する入力
- テキスト · 画像
- 結果
- 動画
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 動画 POST /v1/videos
- 入力の種類
text,image- 出力の種類
video- 出力形式
- 元のMP4バイト列（正規化・トランスコードなし）
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 alibaba/wan-3.0-prime | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドduration | 種類integer | 要件必須 | 値と制限 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 最小値: 1 最大値: 600 | デフォルト— |
フィールドresolution | 種類string | 要件任意 | 値と制限 480p, 720p, 1080p | デフォルト— |
フィールドaspect_ratio | 種類string | 要件任意 | 値と制限 16:9, 4:3, 1:1, 3:4, 9:16 | デフォルト— |
フィールドgenerate_audio | 種類boolean | 要件任意 | 値と制限 false, true | デフォルト— |
フィールドframe_images | 種類array | 要件任意 | 値と制限 最小項目数: 1 最大項目数: 1 入力コンテンツ: フレームオブジェクトの配列。各オブジェクトにはtype=image_url、urlを含むimage_url、およびframe_typeを指定します。HTTPS画像URLを使用し、frame_typeをfirst_frameに設定してください。各フレームの役割はそれぞれ最大一回まで指定できます。 正確なキー: type, image_url, frame_type 条件: これらのキーは各フレームオブジェクトを記述します。image_urlに含めるのはurlのみです。テキストのみのリクエストではframe_imagesを省略してください。 | デフォルト— |
フィールドinput_references | 種類array | 要件任意 | 値と制限 | デフォルト— |
フィールドseed | 種類integer | 要件任意 | 値と制限 最小値: -9,223,372,036,854,775,808 最大値: 9,223,372,036,854,775,807 | デフォルト— |
フィールドcallback_url | 種類string | 要件任意 | 値と制限 パターン: ^https:// | デフォルト— |
フィールドsession_id | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドtrace | 種類object | 要件任意 | 値と制限 | デフォルト— |
フィールドuser | 種類string | 要件任意 | 値と制限 | デフォルト— |
入力素材の組み合わせ
テキストから動画へ · テキストのプロンプト。 · 必須: model, prompt, duration
promptをテキスト、durationを整数の秒数で指定してください。サポートされている解像度を選び、必要に応じてアスペクト比を指定します。
model: 種類: string · alibaba/wan-3.0-prime
prompt: 種類: string · 最大UTF-8バイト数: 10,000 · 空白以外の文字が必須: はい
画像から動画へ · テキストのプロンプトと先頭フレーム画像。 · 必須: model, prompt, duration, frame_images
frame_imagesは配列です。各フレームオブジェクトにはtype、image_url、frame_typeがあり、image_urlにはurlを含めます。typeをimage_urlに設定してください。first_frameを使用します。各フレームの役割は、それぞれ最大一回まで指定できます。各フレームには公開HTTPS画像URLを指定してください。サポートされている解像度を選び、必要に応じてアスペクト比を指定します。
正確なキー: type, image_url, frame_type
model: 種類: string · alibaba/wan-3.0-prime
prompt: 種類: string · 最大UTF-8バイト数: 10,000 · 空白以外の文字が必須: はい
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, prompt, duration |
パラメータmaterial_types | 仕様text, image |
パラメータadditional_properties | 仕様false |
パラメータoptional_controls | 仕様resolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
ライフサイクル: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
料金
最終料金の計算方法
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値（default）を使用する場合
比較用の推定料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 課金単位 | 課金条件 | 料金 |
|---|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 課金単位— | 課金条件— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定動画料金 | 料金表— | 予測数量— | 課金単位動画1秒あたり | 課金条件resolution: 1080p | 料金 出力 · 動画料金 · 比較専用の見積もり $0.56 動画1秒あたり |
| 設定動画料金 | 料金表— | 予測数量— | 課金単位動画1秒あたり | 課金条件resolution: 480p | 料金 出力 · 動画料金 · 比較専用の見積もり $0.136 動画1秒あたり |
| 設定動画料金 | 料金表— | 予測数量— | 課金単位動画1秒あたり | 課金条件resolution: 720p | 料金 出力 · 動画料金 · 比較専用の見積もり $0.28 動画1秒あたり |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 課金単位— | 課金条件— | 料金 出力 · 推定生成コスト · 比較専用の見積もり $0.272 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
参考料金の詳細
モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。
動画設定の料金参照情報
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 課金条件 | 料金 |
|---|---|---|
| 設定動画料金 | 課金条件resolution: 480p | 料金 出力 · 動画料金 $0.136 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
| 設定動画料金 | 課金条件resolution: 720p | 料金 出力 · 動画料金 $0.28 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
| 設定動画料金 | 課金条件resolution: 1080p | 料金 出力 · 動画料金 $0.56 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
リクエスト例
Ailoot Ultra · 動画
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"alibaba/wan-3.0-prime","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
結果を受け取って保存
Ailoot Ultra · 動画
所有コンテンツの署名付きURL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
ジョブのステータスを確認
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
その他のコンテンツ取得
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
完了した結果をすべて保存
完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。
実際に得られた所有出力と、返された実測メタデータをすべて保持してください。
元のレスポンスを確認する場合
503 result_pending_check + 元のid + X-Should-Retry:false；元のリクエストを決して再実行しないでください
レスポンスのフィールド
| フィールド | 種類 | 意味 |
|---|---|---|
フィールドindex | 種類integer | 意味出力リスト内での、この動画のゼロ始まりの位置。 |
フィールドcontent_url | 種類string | 意味この完了済み動画の署名付きHTTPSダウンロードURL。 |
フィールドsha256 | 種類string | null | 意味元の動画バイト列のSHA-256ダイジェスト。取得できない場合はnullです。 |
フィールドsize_bytes | 種類integer | null | 意味元の動画ファイルのサイズ（バイト）。取得できない場合はnullです。 |
フィールドduration_ms | 種類integer | null | 意味実測された動画の長さ（ミリ秒）。取得できない場合はnullです。 |
フィールドwidth | 種類integer | null | 意味動画の幅（ピクセル）。取得できない場合はnullです。 |
フィールドheight | 種類integer | null | 意味動画の高さ（ピクセル）。取得できない場合はnullです。 |
フィールドvideo_codec | 種類string | null | 意味動画コーデックの識別子。記録されていない場合はnullです。 |
フィールドhas_audio | 種類boolean | null | 意味動画に音声トラックが含まれるかどうか。未測定の場合はnullです。 |
フィールドaudio_codec | 種類string | null | 意味音声コーデックの識別子。識別子が記録されていない場合はnullです。 |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス404 · not_found_error | 条件動画へのアクセスが利用できないか、この動画IDが見つかりません。 | 次の手順動画へのアクセス権を確認してください。既存の動画には、元の公開IDと同じAPIキーを使用してください。 |
レスポンス401 · authentication_error | 条件APIキーが認証済みアカウントと一致しません。 | 次の手順送信する前に、APIキーとアカウントのアクセス権を確認してください。 |
レスポンス400 · invalid_request_error | 条件リクエストを読み取れないか、ダウンロードのインデックスが無効です。 | 次の手順リクエスト本文を修正してください。ダウンロードする場合は、元のタスクから返された出力インデックスを選択してください。 |
レスポンス422 · price_unavailable | 条件選択された動画設定の料金を算出できません。 | 次の手順サポートされている動画設定を選び、必須オプションをすべて指定してから、修正したリクエストを送信してください。 |
レスポンス422 · invalid_request_error | 条件動画入力、または元の継続タスクが無効です。 | 次の手順有効なHTTPS入力を使用してください。継続する場合は、完了した元の動画の公開IDと、同じAPIキーを使用してください。 |
レスポンス402 · billing_error | 条件利用可能な残高または上限の制約により、料金を仮押さえできません。 | 次の手順新しいリクエストを送る前に、利用可能な残高と上限を確認してください。 |
レスポンス503 · server_error | 条件動画の検証、保存領域、またはサービスへのアクセスを一時的に利用できません。 | 次の手順サービスが利用可能になるまでお待ちください。すでに動画IDがある場合は、別の生成を作成せず、その元のタスクを確認してください。 |
レスポンス503 · result_pending_check | 条件元の動画の結果と請求額を確認する必要があります。 | 次の手順返された動画IDを保持し、そのタスクを確認してください。確認中に、代わりの生成リクエストを送信しないでください。 |
レスポンス503 · owned_result_unavailable | 条件既存の動画のダウンロードを一時的に利用できません。 | 次の手順後で同じ動画タスクを確認し、その既存の出力をダウンロードしてください。新しい生成を行うと、別の操作が作成されます。 |
レスポンス409 · video_not_ready | 条件動画コンテンツは公開されていません。 | 次の手順元のタスクのステータスを確認してください。completedと報告されたらダウンロードします。failedと報告された場合は、その料金確認の通知に従ってください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra alibaba/wan-3.0-prime
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Alibaba: Wan 3.0 Prime
- 利用できる入力と結果は何ですか？
POST /v1/videos·alibaba/wan-3.0-prime:text,image→video- リクエストはどの項目を使用しますか？
POST /v1/videos·alibaba/wan-3.0-prime:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- どの制限が適用されますか？
POST /v1/videos·alibaba/wan-3.0-prime:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807