HappyHorse ビデオ編集モデルは、動画と参照画像を入力として受け取り、テキストの指示に基づいてスタイル変換や部分的な置換などの編集タスクを実行します。
利用可能なリージョン
モデル、エンドポイント URL、API キーがすべて同じリージョンに属していることを確認してください。リージョンをまたいだ呼び出しは失敗します。
- モデルの選択：モデルがどのリージョンに属しているかを確認します。
- URL の選択：対応するリージョンのエンドポイント URL を使用します。HTTP URL がサポートされています。
- 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 (必須)モデル名。固定値：happyhorse-1.0-video-edit。input object (必須)編集する動画、参照画像、プロンプトなどの入力情報。
プロパティ prompt string (必須)スタイル変換や部分的な置換など、意図する編集を記述するテキストプロンプト。任意の言語をサポートします。最大 5,000 文字 (中国語以外) または 2,500 文字 (中国語)。この制限を超えたコンテンツは自動的に切り捨てられます。media array (必須)編集する動画やオプションの参照画像を含むメディアアセットのリスト。配列には、厳密に 1 つの video 要素と、オプションで 0～5 個の reference_image 要素を含める必要があります。
要素のプロパティ type string (必須)メディアアセットのタイプ。次のいずれかである必要があります：
string (必須)メディアアセットの URL。
動画入力 (type=video) 編集する動画の一般公開されている URL。
出力動画の時間：3～15 秒。
画像入力 (type=reference_image) 参照画像の URL または Base64 エンコードされたデータ。画像の要件：
object (任意)解像度などのビデオ編集パラメーター。
プロパティ resolution string (任意)生成される動画の解像度。有効値：
boolean (任意)生成された動画にウォーターマークを追加するかどうか。ウォーターマークは右下に「Happy Horse」というテキストで表示されます。デフォルトは true です。
string (任意)オーディオコントロール。
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。
- task_id の有効期限：task_id は 24 時間後に有効期限が切れます。有効期限が切れると、結果を取得できなくなり、API は
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 時間有効です。動画は H.264 エンコーディングの MP4 フォーマットです。orig_prompt stringリクエストパラメーター prompt に対応する元の入力プロンプトです。code stringエラーコード。リクエストが失敗した場合にのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。リクエストが失敗した場合にのみ返されます。「エラーコード」をご参照ください。object使用量の統計。成功した結果のみがカウントされます。
プロパティ duration float生成された動画の合計動画時間で、課金に使用されます。SR integer生成された動画の解像度ティア。output_video_duration float出力動画の長さ (秒)。input_video_duration float入力動画の長さ (秒)。video_count integer生成された動画の数。常に 1 です。stringトレースとトラブルシューティングのための一意のリクエスト識別子。 |
動画 URL は 24 時間のみ有効で、その後自動的に消去されます。生成された動画は速やかに保存してください。 |