申請プロセス
Veo Videos Generation API を使用するには、まず Ace Data Cloud コンソール にアクセスして、APIトークンを取得し、保管してください。
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。
1つのAPIトークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般残高をチャージできます。
📘 完全なドキュメント：Veo Videos Generation API →
基本使用
まず、基本的な使用方法を理解します。これは、プロンプトprompt、生成アクション action、先頭と末尾のフレーム参照画像配列 image_urls、およびモデル model を入力することで、処理された結果を得ることができます。最初に、action フィールドを簡単に渡す必要があります。その値は text2video で、主に3つのアクションが含まれます：テキストから動画（text2video）、画像から動画（image2video）、1080p動画の取得（get1080p）。次に、モデル model を入力する必要があります。現在、主に veo31-fast、veo3、veo31、veo3-fast、および veo31-fast-ingredients モデルがあります。具体的な内容は以下の通りです：
accept：受け取りたいレスポンス結果の形式。ここではapplication/json、つまりJSON形式を記入します。authorization：APIを呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
model：生成する動画のモデル。主にveo31-fast、veo3、veo31、veo3-fast、およびveo31-fast-ingredientsモデルがあります。action：今回の動画生成タスクのアクション。主に3つのアクションが含まれます：テキストから動画（text2video）、画像から動画（image2video）、1080p動画の取得（get1080p）。image_urls：画像から動画アクションimage2videoを選択した場合に必ずアップロードする必要がある参照画像のリンク。veo31-fast-ingredientsは最大3枚（複数画像融合）、他のモデルは最大2枚（先頭と末尾のフレームモード）。resolution：生成する動画の解像度を選択します。veo31モデルは4k解像度をサポートし、他のモデルはサポートしていません。すべてのモデルは1080pおよびgif解像度をサポートし、この値を指定しない場合はデフォルトで720p解像度が使用されます。主に：1080p、gif、4k。prompt：プロンプト。callback_url：結果をコールバックするURL。async：オプション。trueに設定すると、インターフェースはすぐにtask_idを返し、callback_urlを提供する必要がなくなります。その後、対応するタスククエリインターフェースを通じて結果をポーリングして取得します。
📌 モデル説明のまとめ
🔑 重要ルールの説明
- 一般的なロジック：
- 画像入力なし → 自動的にテキストから動画モードがトリガーされます。
- 画像入力あり → 画像から動画モードがトリガーされます（具体的な動作は画像の数によって決まります）。
- 画像から動画モードのタイプ：
- 先頭フレームモード（1枚の画像）：先頭フレームは入力画像に固定されます。
- 先頭と末尾フレームモード（2枚の画像）：先頭フレームと末尾フレームは入力画像に固定されます。
- 複数画像融合モード（1-3枚の画像）：
veo31-fast-ingredientsのみがサポートし、複数画像の内容を融合して動画を生成します。
- モード分類：
- ファストモード：
veo3-fast、veo31-fast、veo31-fast-ingredients。 - クオリティモード：
veo3、veo31（生成品質が高い）。
⚠️ 注意事項
- 唯一の強制画像入力モデル：
veo31-fast-ingredientsは画像を必ず入力する必要があります（1-3枚）、そうでないと実行できません。 - 画像数の制限：
veo31-fast-ingredientsは 1-3枚の画像入力をサポートします（複数画像融合モード）。- 他のモデルは最大 2枚の画像入力をサポートします（先頭と末尾フレームモード）。
success、この時点での動画生成タスクの状態。task_id、この時点での動画生成タスクID。data、この時点での動画生成タスクの結果。id、この時点での動画生成タスクの動画ID。video_url、この時点での動画生成タスクの動画リンク。created_at、この時点での動画生成タスクの作成時間。complete_at、この時点での動画生成タスクの完了時間。state、この時点での動画生成タスクの状態。
data の動画リンクアドレスに基づいて生成されたVeo動画を取得するだけです。
また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURLのコードは以下の通りです：
画像から動画生成機能
もし、先頭と末尾のフレーム画像に基づいて動画を生成したい場合は、パラメータaction を image2video に設定し、先頭と末尾のフレーム画像リンクの配列 image_urls を入力する必要があります。
次に、生成動画をカスタマイズするために拡張する必要があるプロンプトを入力する必要があります。以下の内容を指定できます：
model：生成動画のモデル、主にveo31-fast、veo3、veo31、veo3-fastおよびveo31-fast-ingredientsがあります。image_urls：画像から動画生成行動image2videoを選択した場合に必ずアップロードする必要がある参考画像リンク。prompt：プロンプト。
1080p動画取得機能
もし、既に生成されたVeo動画の1080pを取得したい場合は、パラメータaction を get1080p に設定し、1080pを取得する必要がある動画のIDを入力します。動画IDの取得は基本的な使用に基づいて行います。以下の図のように：
注意：ここでの動画の video_id は生成後の動画のIDです。動画を生成する方法がわからない場合は、前述の基本的な使用を参考にして動画を生成してください。
次に、生成動画をカスタマイズするために拡張する必要があるプロンプトを入力する必要があります。以下の内容を指定できます：
model：生成動画のモデル、主にveo31-fast、veo3、veo31、veo3-fastおよびveo31-fast-ingredientsがあります。video_id：参考動画ID、1080p動画を取得するために使用します。
指定動画サイズ生成
もし、カスタムサイズのVeo動画を生成したい場合は、パラメータaspect_ratio を希望のサイズに設定します。次に、生成動画をカスタマイズするために拡張する必要があるプロンプトを入力する必要があります。以下の内容を指定できます：
model：生成動画のモデル、主にveo31-fast、veo3、veo31、veo3-fastおよびveo31-fast-ingredientsがあります。aspect_ratio：動画のサイズ、現在サポートされているのは16:9、16:9、3:4、4:3、1:1で、デフォルトは16:9です。translation：プロンプトの自動翻訳を有効にするかどうか、デフォルトはfalseです。 入力例は以下の通りです：
非同期コールバック
Veo Videos Generation APIによる生成には比較的長い時間がかかり、約1〜2分必要です。APIが長時間応答しない場合、HTTPリクエストは接続を維持し続け、追加のシステムリソースを消費するため、本APIは非同期コールバックのサポートも提供しています。 全体の流れは、クライアントがリクエストを発行する際に、追加でcallback_urlフィールドを指定し、クライアントがAPIリクエストを発行した後、APIはすぐに結果を返し、現在のタスクIDを示すtask_idフィールド情報を含みます。タスクが完了すると、生成された動画の結果がPOST JSON形式でクライアントが指定したcallback_urlに送信され、その中にもtask_idフィールドが含まれているため、タスクの結果をIDで関連付けることができます。
以下の例を通じて、具体的にどのように操作するかを理解しましょう。
まず、WebhookコールバックはHTTPリクエストを受信できるサービスであり、開発者は自分が構築したHTTPサーバーのURLに置き換える必要があります。ここではデモのために、公開のWebhookサンプルサイトhttps://webhook.site/を使用します。このサイトを開くとWebhook URLが得られます。
このURLをコピーすればWebhookとして使用できます。ここでのサンプルはhttps://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dcです。
次に、フィールドcallback_urlを上記のWebhook URLに設定し、対応するパラメータを入力します。具体的な内容は以下の通りです：
https://webhook.site/aed5cd28-f8aa-4dca-9480-8ec9b42137dcで生成された動画の結果を確認できます。以下のようになります：
内容は以下の通りです：
task_idフィールドがあり、他のフィールドは上記と似ています。このフィールドを通じてタスクの関連付けが可能です。
エラーハンドリング
APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードとメッセージを返します。例えば：400 token_mismatched：不正なリクエスト、パラメータが欠落または無効な可能性があります。400 api_not_implemented：不正なリクエスト、パラメータが欠落または無効な可能性があります。401 invalid_token：認証されていない、無効または欠落した認証トークン。429 too_many_requests：リクエストが多すぎます、レート制限を超えました。500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。