一貫性のある動画のためのVidu Q3 Reference API

独立したGoEnhanceオープンAPIを通じてVidu Q3リファレンスにアクセスします。1〜7枚のリファレンス画像とプロンプトを提供し、非同期ビデオタスクを送信した後、返されたimg_uuidでポーリングするか、ステータスコールバックを受け取ります。
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の機能と制限

モデルとプロンプト

modelをviduq3_referenceに設定し、目的の動画を説明する必須のテキストプロンプトを提供します。

参照画像

image_urlsに1〜7個のURLを送信します。各画像はPNG、JPEG、JPG、またはWebP形式である必要があり、サイズは128×128ピクセル以上、50MB以下、アスペクト比は1:4から4:1の間である必要があります。

専用入力モード

このルートはimage_urlやimage_end_urlではなく、image_urlsを受け付けます。テキストのみ、最初のフレーム、または開始・終了フレームの生成にはviduq3_proを使用してください。

長さ

3秒から16秒の間で整数を選択します。ドキュメント上のデフォルトは5秒です。

解像度

540p、720p、または1080pを選択します。ドキュメント上のデフォルトは720pです。

出力比

ratioを16:9、9:16、または1:1に設定します。ドキュメント上のデフォルトは16:9です。aspect_ratioも互換性のあるエイリアスとして受け付けられます。
コストは、選択した秒単価にリクエストした秒数を乗じて算出します。

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. 完了を処理する

成功および失敗の状態をべき等に処理し、後続のプロセスで使用する前に生成されたアセットを確認します。
APIキーを取得する
明示的な入力と最終的なタスク状態に基づいて、再現可能なリファレンスから動画へのワークフローを構築します。

Vidu Q3 Reference APIの開発者向けユースケース

キャラクター主導のキャンペーンクリップ

承認済みの架空のキャラクターやタレントのリファレンスを、短いキャンペーン動画のコンセプトに反映させます。

製品アイデンティティシーケンス

承認済みの複数の製品ビューを視覚的リファレンスとして使用し、動きに焦点を当てたクリエイティブな探索を行います。

ストーリーの連続性

絵コンテやプリビジュアライゼーションのワークフロー用に個別のショットを生成する際、繰り返し登場する被写体をリファレンスとして使用します。

ローカライズされたクリエイティブバリエーション

地域ごとのキャンペーンコンセプトに合わせてプロンプトを調整しながら、承認済みの視覚的リファレンスを再利用します。

スタイルの一貫したソーシャルアセット

管理された視覚的リファレンスと出力比率のセットに基づいて、ショート動画パイプラインを構築します。

クリエイティブなプロトタイピング

より広範な制作ワークフローに着手する前に、リファレンスの組み合わせ、プロンプト、期間、解像度をテストします。
価格設定、リファレンス入力、非同期タスク、およびShengShu APIに関する一般的な質問への回答です。

Vidu Q3 Reference APIに関するよくある質問

GoEnhanceにおけるVidu Q3 Reference APIのエンドポイントは何ですか?

model を viduq3_reference に設定して POST https://api.goenhance.ai/api/v1/videos/generations を送信します。送信が成功すると、非同期追跡用の img_uuid が返されます。

Vidu Q3 Reference APIの料金体系はどのようになっていますか?

料金は生成秒数に基づきます:540pで1.75トークン/秒($0.035/秒)、720pで3トークン/秒($0.06/秒)、1080pで3.75トークン/秒($0.075/秒)です。選択したレートに期間を乗じてください。

リファレンス画像は何枚まで送信できますか?

ドキュメントに記載されている image_urls 配列には1~7枚の画像が必要です。それぞれが公開されている形式、サイズ、寸法、アスペクト比の制限を満たしている必要があります。

image_urlやimage_end_urlを送信できますか?

いいえ。この専用リファレンスルートは image_urls を受け付けます。テキストから動画への変換、最初のフレーム画像から動画への変換、または開始・終了フレーム生成には、別途ドキュメント化されている viduq3_pro ルートを使用してください。

どの期間、解像度、比率の値がサポートされていますか?

動画の長さは3〜16秒です。解像度は540p、720p、1080pに対応しています。アスペクト比は16:9、9:16、1:1に対応しています。

動画の生成が完了したかどうかはどのように確認できますか?

img_uuidを保持してGET /api/v1/jobs/detailをポーリングするか、公開されているHTTPSのcustom_callback_urlを指定してください。200以外のコールバック応答が返された場合、1回あたり3秒のタイムアウトで最大3回まで再試行されます。

これは公式のShengShu APIですか?

いいえ。ViduはShengShu Technologyによって開発されています。このページではGoEnhanceを通じた独立したサードパーティによるAPIアクセスについて説明しており、提携、パートナーシップ、または推奨を意味するものではありません。

Vidu Q3 ReferenceとTurboリファレンス階層の違いは何ですか?

このページでは標準のviduq3_referenceルートについて説明しています。別途ドキュメント化されているviduq3_turbo_referenceルートは、より高速で低価格なリファレンス階層です。このリクエストにそのモデル識別子や価格設定を混同させないでください。

Vidu Q3 Reference APIで開発を始める