img_uuidでポーリングするか、ステータスコールバックを受け取ります。一貫性のある動画のためのVidu Q3 Reference API
独立したGoEnhanceオープンAPIを通じてVidu Q3リファレンスにアクセスします。1〜7枚のリファレンス画像とプロンプトを提供し、非同期ビデオタスクを送信した後、返された
APIキーを取得
Vidu Q3 Reference APIリクエストを作成する
一貫性を実現するために構築された参照画像入力
model: viduq3_reference、必須のプロンプト、および1〜7枚の公開参照画像を含むimage_urlsを指定して、https://api.goenhance.ai/api/v1/videos/generationsにPOSTリクエストを送信します。
検証済みリクエストと非同期結果
送信前に画像の形式、寸法、アスペクト比、長さ、解像度、出力比を検証してください。img_uuidを保持し、GET /api/v1/jobs/detailをポーリングするか、公開HTTPSコールバックを使用します。
タスクを送信する前に、ドキュメント化された参照画像から動画へのリクエストスキーマと一致していることを確認してください。
Vidu Q3 Reference APIの機能と制限
モデルとプロンプト
<code>model</code>を<code>viduq3_reference</code>に設定し、目的の動画を説明する必須のテキストプロンプトを提供します。
参照画像
<code>image_urls</code>に1〜7個のURLを送信します。各画像はPNG、JPEG、JPG、またはWebP形式である必要があり、サイズは128×128ピクセル以上、50MB以下、アスペクト比は1:4から4:1の間である必要があります。
専用入力モード
このルートは<code>image_url</code>や<code>image_end_url</code>ではなく、<code>image_urls</code>を受け付けます。テキストのみ、最初のフレーム、または開始・終了フレームの生成には<code>viduq3_pro</code>を使用してください。
長さ
3秒から16秒の間で整数を選択します。ドキュメント上のデフォルトは5秒です。
解像度
<code>540p</code>、<code>720p</code>、または<code>1080p</code>を選択します。ドキュメント上のデフォルトは<code>720p</code>です。
出力比
<code>ratio</code>を<code>16:9</code>、<code>9:16</code>、または<code>1:1</code>に設定します。ドキュメント上のデフォルトは<code>16:9</code>です。<code>aspect_ratio</code>も互換性のあるエイリアスとして受け付けられます。
コストは、選択した秒単価にリクエストした秒数を乗じて算出します。
Vidu Q3 Reference APIの料金
540p
生成1秒あたり1.75トークン。ドキュメント上の1トークンあたり$0.02のレートで、1秒あたり$0.035に相当します。
720p
生成1秒あたり3トークン。ドキュメント上の1トークンあたり$0.02のレートで、1秒あたり$0.06に相当します。
1080p
生成1秒あたり3.75トークン。ドキュメント上の1トークンあたり$0.02のレートで、1秒あたり$0.075に相当します。
Vidu Q3 Referenceを6ステップで統合する
1
1. APIキーを作成する
GoEnhanceキーを作成し、AuthorizationヘッダーにBearerトークンとして送信します。
2
2. リファレンスを準備する
1～7枚の準拠したリファレンス画像をパブリックURLでホストし、プロンプトで保持すべき視覚的詳細を決定します。
3
3. リクエストを検証する
viduq3_reference、3～16秒の期間、サポートされている解像度、およびサポートされている比率を設定します。 4
4. タスクを送信する
/api/v1/videos/generations にPOSTし、返された img_uuid を保持します。 5
5. ステータスを追跡する
GET /api/v1/jobs/detail をポーリングするか、パブリックHTTPSの custom_callback_url を設定します。 6
6. 完了を処理する
成功および失敗の状態をべき等に処理し、後続のプロセスで使用する前に生成されたアセットを確認します。
明示的な入力と最終的なタスク状態に基づいて、再現可能なリファレンスから動画へのワークフローを構築します。
Vidu Q3 Reference APIの開発者向けユースケース
キャラクター主導のキャンペーンクリップ
承認済みの架空のキャラクターやタレントのリファレンスを、短いキャンペーン動画のコンセプトに反映させます。
製品アイデンティティシーケンス
承認済みの複数の製品ビューを視覚的リファレンスとして使用し、動きに焦点を当てたクリエイティブな探索を行います。
ストーリーの連続性
絵コンテやプリビジュアライゼーションのワークフロー用に個別のショットを生成する際、繰り返し登場する被写体をリファレンスとして使用します。
ローカライズされたクリエイティブバリエーション
地域ごとのキャンペーンコンセプトに合わせてプロンプトを調整しながら、承認済みの視覚的リファレンスを再利用します。
スタイルの一貫したソーシャルアセット
管理された視覚的リファレンスと出力比率のセットに基づいて、ショート動画パイプラインを構築します。
クリエイティブなプロトタイピング
より広範な制作ワークフローに着手する前に、リファレンスの組み合わせ、プロンプト、期間、解像度をテストします。
価格設定、リファレンス入力、非同期タスク、およびShengShu APIに関する一般的な質問への回答です。