img_uuidを保持した後、タスクが成功または失敗するまでポーリングを行うか、コールバックを受け取ります。動画生成用Wan 3.0 API
テキストから動画への変換、ファーストフレーム生成、および開始・終了フレーム生成のために、独立したGoEnhanceオープンAPIを通じてWan 3.0にアクセスします。非同期リクエストを送信し、返された
APIキーを取得
適切なWan 3.0 APIリクエストモードを選択
プロンプトおよびフレームガイド付き生成
model: wan-3-0 を指定して https://api.goenhance.ai/api/v1/videos/generations にPOSTリクエストを送信します。プロンプトのみを使用するか、開始フレーム用に image_url を追加し、終了フレームが必要な場合は image_end_url を併せて追加してください。
リファレンス素材用の個別のルート
順序付けられたリファレンス画像、動画、音声、ドキュメント、またはウェブページには model: wan-3-0-refs を使用してください。リファレンス素材と開始・終了フレーム入力を混在させないでください。これらのモードは相互に排他的です。
タスクが動画パイプラインに入る前に、ドキュメント化されたフィールドを検証してください。
Wan 3.0 APIの機能とリクエストフィールド
必須のモデルとプロンプト
標準ルートでは、<code>model</code> を <code>wan-3-0</code> に設定し、テキストの <code>prompt</code> を提供してください。
開始フレームと終了フレーム
開始フレームには <code>image_url</code> を追加します。<code>image_end_url</code> はオプションですが、使用する場合は必ず <code>image_url</code> と併用する必要があります。
アスペクト比
アダプティブ、16:9、4:3、1:1、3:4、9:16から選択します。ドキュメント上のデフォルトはアダプティブであり、21:9はリストに含まれていません。
動画の長さ
2秒から30秒までの任意の整数を選択します。ドキュメント上のデフォルトは5秒です。
解像度と音声
480p、720p、1080pから選択します。GoEnhanceのデフォルトは720pです。<code>generate_audio</code> はデフォルトで有効（true）であり、追加の生成料金は発生しません。
シードとコールバック
オプションで0から2147483647までのシードを設定し、ステータス更新用に公開HTTPSの <code>custom_callback_url</code> を提供します。
Wan 3.0のどちらのルートも、1秒あたりの料金は同一です。コストは、選択したレートにリクエストした秒数を乗じて算出してください。
Wan 3.0 APIの料金
480pの料金
生成1秒あたり2.91トークン。ドキュメント記載の1トークンあたり$0.02のレートに基づき、1秒あたり$0.0582に相当します。
720pの料金
生成1秒あたり5.82トークン。ドキュメント記載の1トークンあたり$0.02のレートに基づき、1秒あたり$0.1164に相当します。
1080pの料金
生成1秒あたり11.64トークン。ドキュメント記載の1トークンあたり$0.02のレートに基づき、1秒あたり$0.2328に相当します。
6つのステップでWan 3.0 APIを統合する
1
1. APIキーを作成する
GoEnhanceキーを作成し、Authorizationヘッダーにベアラートークンとして送信します。
2
2. 入力モードを選択する
プロンプトまたは開始/終了フレームには
wan-3-0 を、参照資料を使用する場合は wan-3-0-refs を使用してください。 3
3. リクエストを検証する
送信前に、必須フィールド、フレームの依存関係、秒数、解像度、アスペクト比、および参照制限を確認してください。
4
4. タスクを送信する
/api/v1/videos/generations にPOSTリクエストを送信し、返された img_uuid を保存してください。 5
5. ステータスを追跡する
GET /api/v1/jobs/detail をポーリングするか、公開HTTPSコールバックURLで更新を受け取ります。 6
6. 完了処理を行う
成功および失敗の処理を冪等（べきとう）に行い、返されたアセットを検証します。また、参照ジョブがアップストリームで失敗した場合は、返金されたトークンを考慮してください。
明示的な入力とタスクの終了状態に基づいた、再現可能な動画生成ワークフローを構築します。
Wan 3.0 APIの開発者向けユースケース
キャンペーン動画のバリエーション
構造化されたプロンプトから短いコンセプトクリップを生成し、クリエイティブのレビューやその後の組み立てに活用します。
プロダクトモーション
承認済みの開始フレームをアニメーション化します。その際、プロンプト、フレーミング、完了処理はアプリケーション側で制御します。
絵コンテのトランジション
開始フレームと終了フレームを提供し、承認済みの2つのビジュアル間の動きを検討します。
参照主導のクリエイティブ
順序付けられた画像、動画、音声、ドキュメント、またはWebページに依存するワークフローでは、個別の参照ルートを使用してください。
ローカライズされたコンテンツパイプライン
非同期タスクハンドラーを変更することなく、地域ごとのバリエーションに合わせてプロンプトをパラメータ化します。
プリビジュアライゼーション
簡潔なショット説明を、本格的な制作前のレビュー可能なモーションコンセプトに変換します。
料金、リクエストモード、検証、タスクステータス、およびAlibaba APIに関する一般的な質問への回答です。