img_uuidを保持した後、ジョブが成功または失敗するまでポーリングを行うか、コールバックを受け取ります。動画生成用Vidu Q3 Pro API
テキストから動画、画像から動画、および開始・終了フレーム生成のための独立したGoEnhanceオープンAPIを通じて、Vidu Q3 Proにアクセスします。非同期リクエストを1件送信し、返された
APIキーを取得
明確なVidu Q3 Pro APIリクエストを作成する
1つのエンドポイントで3つの入力モードに対応
model: viduq3_proを指定して、https://api.goenhance.ai/api/v1/videos/generationsにPOSTリクエストを送信します。テキストから動画を生成する場合はプロンプトのみを使用し、最初のフレームを指定する場合はimage_urlを追加し、開始・終了フレームを指定する場合はimage_end_urlを追加します。
明示的な制御と非同期完了
送信前に期間、解像度、テキストから動画への比率を検証します。返されたタスクIDを保存し、GET /api/v1/jobs/detailまたは公開HTTPSのcustom_callback_urlを使用して最終結果を処理します。
タスクが動画パイプラインに入る前に、ドキュメント化されたリクエストスキーマと一致していることを確認してください。
Vidu Q3 Pro APIの機能とパラメータ
モデル
<code>model</code>を<code>viduq3_pro</code>に設定します。
プロンプト
目的の動画を説明する必須のテキストプロンプトを提供します。
最初のフレーム
画像から動画を生成するには公開されている<code>image_url</code>を追加します。テキストから動画を生成する場合は省略してください。
最後のフレーム
開始・終了フレームによる制御を行うには、<code>image_url</code>と共に<code>image_end_url</code>を追加します。
期間
1から16秒の間で整数を選択します。ドキュメント上のデフォルトは5秒です。
解像度と比率
解像度は540p、720p、1080pに対応しており、デフォルトは720pです。<code>ratio</code>フィールドはテキストから動画へのリクエストに適用されます。
生成コストは、選択した秒単価にリクエストした秒数を乗じて算出します。
Vidu Q3 Pro APIの料金
540p
生成1秒あたり2.25トークン。ドキュメント記載の1トークンあたり$0.02のレートで、1秒あたり$0.045に相当します。
720p
生成1秒あたり5トークン。ドキュメント記載の1トークンあたり$0.02のレートで、1秒あたり$0.10に相当します。
1080p
生成1秒あたり6トークン。ドキュメント記載の1トークンあたり$0.02のレートで、1秒あたり$0.12に相当します。
Vidu Q3 Proを6ステップで統合する
1
1. APIキーを作成する
GoEnhanceキーを作成し、AuthorizationヘッダーにBearerトークンとして送信します。
2
2. 入力モードを選択する
プロンプトのみを使用するか、開始フレームのURLを追加するか、開始フレームと終了フレームの両方のURLを追加します。
3
3. リクエストを検証する
viduq3_pro、1〜16秒の期間、およびドキュメント化された解像度値のいずれかを設定します。 4
4. 動画タスクを送信する
/api/v1/videos/generationsにPOSTし、返されたimg_uuidを保持します。 5
5. ステータスを追跡する
GET /api/v1/jobs/detailをポーリングするか、公開HTTPSコールバックURLを設定します。 6
6. 完了処理を行う
成功および失敗の状態をべき等に処理し、後続のプロセスで使用する前に返されたアセットを検証します。
明示的な入力と最終的なタスク状態に基づき、繰り返し可能な動画生成ワークフローを構築します。
Vidu Q3 Pro APIのデベロッパー向けユースケース
キャンペーン動画のバリエーション
構造化されたプロンプトから短いコンセプトクリップを生成し、クリエイティブのレビューや後続の組み立てに活用します。
プロダクトモーション
承認済みの製品フレームをアニメーション化し、アプリケーション側でプロンプト、検証、アセットレビューを制御します。
ストーリーボードのトランジション
開始フレームと終了フレームの入力を活用し、2つの承認済みビジュアル間の動きを検討します。
ローカライズされたクリエイティブパイプライン
非同期タスクハンドラーを変更することなく、地域ごとのキャンペーンバリエーションに合わせてプロンプトをパラメータ化します。
ソーシャル動画制作
アプリケーションで選択した解像度と期間で、短いモーションアセットを作成します。
プリビジュアライゼーション
簡潔なショット説明を、本格的な制作前のレビュー可能なモーションコンセプトに変換します。
料金、入力、タスクステータス、およびShengShu動画APIに関する一般的な質問への回答。