HappyHorse モデルを使用して、テキストプロンプトから物理的にリアルで動きの滑らかな動画を生成します。
可用性
モデル、エンドポイント URL、API キーは同じリージョンに属している必要があります。リージョンをまたいだ呼び出しは失敗します。
- モデルの選択:モデルが属するリージョンを確認します。
- URL の選択:リージョンのエンドポイント URL を使用します。HTTP がサポートされています。
- API キーの設定:リージョンの API キーを取得し、API キーを環境変数としてエクスポートします。
このトピックのサンプルコードは、シンガポールリージョンに適用されます。
HTTP リクエスト
テキスト動画生成タスクは通常 1~5 分かかります。API は、「タスクの作成 → 結果のポーリング」という 2 つのステップからなる非同期呼び出しを使用します。
ステップ 1:タスクを作成し、タスク ID を取得
- シンガポール
- 米国 (バージニア)
- 中国 (北京)
- ドイツ (フランクフルト)
- 日本 (東京)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} を実際の ワークスペース ID に置き換えてください。
- タスクが作成された後、返された
task_idを使用して結果をクエリします。task_idは 24 時間有効です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。 - 初心者向けのガイダンスについては、「Postman または cURL を使用した API 呼び出し」をご参照ください。
リクエストパラメーターContent-Typestring (必須)リクエストのコンテンツタイプ。application/json である必要があります。Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみをサポートします。enable である必要があります。リクエストボディmodelstring (必須)モデル名。利用可能なモデルについては、Model Studio コンソールをご参照ください。例:happyhorse-1.1-t2v。input object (必須)モデルの入力。
プロパティ prompt string (必須)生成する動画のテキスト説明。任意の言語をサポートします。最大 5,000 文字 (中国語以外) または 2,500 文字 (中国語)。超過分は切り捨てられます。object (任意)動画出力設定 (解像度、縦横比、持続時間)。
プロパティ resolution string (任意)出力動画の解像度。有効値:
string (任意)出力動画の縦横比。有効値:
integer (任意)出力動画の持続時間 (秒)。
boolean (任意)ウォーターマークを追加するかどうか。右下に「HappyHorse」と表示されます。
integer (任意)乱数シードは [0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。シードを固定すると、再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果が保証されるわけではありません。 |
|
レスポンスパラメーターoutputobjectタスクの出力情報。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
stringトレースとトラブルシューティングのためのユニークなリクエスト識別子。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
task_id を保存して、タスクのステータスと結果をクエリします。 |
ステップ 2:タスク ID で結果をクエリ
- シンガポール
- 米国 (バージニア)
- 中国 (北京)
- ドイツ (フランクフルト)
- 日本 (東京)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}- ポーリングの推奨事項:動画生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
- タスク状態の遷移:PENDING → RUNNING → SUCCEEDED または FAILED。
- 結果リンク:タスクが成功すると、24 時間有効な動画 URL が返されます。動画をダウンロードし、OSS などの永続ストレージに保存してください。
task_idの有効期間:24 時間。この期間を過ぎると、クエリはタスクのステータスをUNKNOWNとして返します。
リクエストパラメーターヘッダーAuthorizationstring (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。パスパラメーターtask_idstring (必須)タスクの ID。 |
{task_id} を前の API 呼び出しで返された task_id の値に置き換えてください。task_id は 24 時間クエリに有効です。{WorkspaceId} を実際の ワークスペース ID に置き換えてください。 |
レスポンスパラメーターoutputobjectタスクの出力情報。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
stringタスクが送信された時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_url string生成された動画の URL。task_status が SUCCEEDED の場合にのみ返されます。24 時間有効です。動画は MP4 フォーマットで、H.264 エンコーディングです。orig_prompt string元の入力プロンプト。リクエストパラメーターの prompt に対応します。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。object出力統計。成功したタスクのみがカウントされます。
プロパティ input_video_duration integer入力動画の持続時間 (秒)。output_video_duration integer出力動画の持続時間 (秒)。duration integer課金対象の合計動画持続時間。SR integer出力動画の解像度。ratio string出力動画の縦横比。video_count integer出力動画の数。常に 1 です。stringトレースとトラブルシューティングのためのユニークなリクエスト識別子。 |
動画 URL は 24 時間のみ有効で、その後自動的にパージされます。生成された動画は速やかに保存してください。 |