Veo API access は、モデル名だけを見れば簡単そうに見えます。ですが本番運用では、モデルのライフサイクル確認、秒単位の料金、非同期オペレーション、解像度の選択、リトライコスト、ルートレベルの可観測性を伴う動画ワークフローです。チームが Veo を Seedance、Sora 風のルート、または 1 つのゲートウェイの背後にある別の動画モデルと比較しているなら、アクセスは 1 行の API 置き換えではなく、チェックリストとして扱ってください。
このガイドは、2026 年 6 月 17 日 Asia/Shanghai 時点で、Google の Gemini API Veo 動画ドキュメント、Google の Veo 3.1 料金表、最新の Ahrefs MCP 実行結果、そしてライブの Flatkey 料金カタログのスナップショットを確認したうえで作成されています。目的は、すべてのルートが今日すぐ本番対応可能だと主張することではありません。目的は、課金対象の動画ジョブをマルチプロバイダーのルーターに流す前に、何を正確に確認すべきかを示すことです。
Veo API アクセスで確認すべきこと: クイックアンサー
本番トラフィック向けに Veo API アクセス を承認する前に、次の7項目を確認してください:
- 公式モデル ID: ワークフローに
veo-3.1-generate-preview、veo-3.1-fast-generate-preview、veo-3.1-lite-generate-previewのどれが必要かを決定します。 - ライフサイクルの状態: 短期的な移行対応でない限り、古い Veo 3.0 と Veo 2.0 の ID は避けてください。Google はこれらを 2026年6月30日の終了対象として案内しています。
- 価格単位: 他のトークン/リソースパック型の動画提供サービスと比較する前に、Veo を秒数、解像度、バリアントで正規化します。
- 非同期ジョブの経路: オペレーション名、ポーリング状態、最終的な動画数、継続時間、解像度、リトライ回数、失敗理由を記録します。
- Flatkey カタログ行: トラフィックを流す当日に、正確なモデル行、エンドポイントファミリー、グループ、価格ラベル、利用可能ステータスを確認します。
- フォールバックルール: 失敗した Veo ジョブを別ルートに切り替えてよい条件と、品質または予算上の理由でクローズドフェイルにすべき条件を決めます。
- 利用証跡: 小規模なテストを実施し、ダッシュボードに選択したモデル、ルート、ステータス、課金単位、コストオーナーが表示されることを確認します。
これが Veo API アクセス の実務的な意味です。単に「Veo を呼び出せるか」ではなく、「どの動画ルートが実行され、いくらかかり、失敗時にどうなるかを証明できるか」です。
Veo API アクセスチェックリスト
| チェック項目 | 重要な理由 | 保存する証跡 |
|---|---|---|
| Model ID | Veo のバリエーションは、コスト、レイテンシ、解像度、またはルートサポートにおいて互換ではありません。 | 公式の Google model ID と、それに対応する Flatkey の行。 |
| Endpoint family | ゲートウェイが OpenAI 互換のインターフェースを提供していても、動画ルートは chat completion のように動作しない場合があります。 | エンドポイント種別、リクエストテンプレート、受け入れられるパラメータ、レスポンス形状。 |
| Pricing unit | Veo は秒単位で記載されますが、他の動画プロバイダーはトークン、生成メディア、またはリソースパックを使用する場合があります。 | バリエーション、解像度、想定秒数、リトライポリシー、価格ソースの日付。 |
| Async operation logging | Veo の生成は送信してポーリングするフローを使用するため、1 回のユーザー操作で複数の内部イベントが作成されることがあります。 | Operation ID、ポーリング試行回数、最終ステータス、生成された動画メタデータ、リトライ回数。 |
| Availability status | カタログの行は、本番ルートで成功したことと同じではありません。 | ダッシュボードのステータス、最終確認時刻、テストレスポンス、使用ログのエントリ。 |
| Fallback boundary | 動画モデルを切り替えると、スタイル、長さ、品質、ポリシーの挙動、コストが変わる可能性があります。 | 承認済みのフォールバックマトリクスと fail-closed 条件。 |
公式の Veo モデルとライフサイクルを確認する
Google の Gemini API ドキュメントでは、現在 Veo の生成例に veo-3.1-generate-preview が使用されています。料金表には 3 つの Veo 3.1 プレビュー ID、veo-3.1-generate-preview、veo-3.1-fast-generate-preview、veo-3.1-lite-generate-preview が記載されています。これは Veo API access の確認を始める最初の場所です。というのも、ゲートウェイのカタログには、古い ID、エイリアス、プロバイダー固有のラベルが同時に含まれている場合があるためです。
ライフサイクルは現在の ID と同じくらい重要です。この記事のために確認した Google の料金ページでは、Veo 3 モデル veo-3.0-generate-001 と veo-3.0-fast-generate-001 は非推奨であり、2026 年 6 月 30 日に停止予定であると警告されています。また、Veo 2 veo-2.0-generate-001 も非推奨であり、同じく 2026 年 6 月 30 日に停止予定だと記載されています。古いコードサンプル、保存済みルート、またはダッシュボードのお気に入りがまだそこを指している場合は、承認済みのアクセス経路ではなく、移行タスクとして扱ってください。
比較する前にVeo APIの料金を正規化する
Veo API accessでは、見出しの料金だけではなく、リクエストを正規化してから比較することが重要です。Googleの現在のVeo 3.1の有料ティア料金はUSD建てで秒単位で記載されており、Standard、Fast、Liteの各バリアントで行が分かれています。
| Veo 3.1 Variant | Official Model ID | Pricing Checked | Planning Note |
|---|---|---|---|
| Standard | veo-3.1-generate-preview |
$0.40/sec at 720p or 1080p; $0.60/sec at 4K. | 品質要件がデフォルトの高い料金行に見合う場合に使用します。 |
| Fast | veo-3.1-fast-generate-preview |
$0.10/sec at 720p; $0.12/sec at 1080p; $0.30/sec at 4K. | ユーザー向けジョブをここに振り分ける前に、出力品質とレイテンシーをテストしてください。 |
| Lite | veo-3.1-lite-generate-preview |
$0.05/sec at 720p; $0.08/sec at 1080p; 4K not supported. | 4Kが不要な場合の、より低コストな下書きに有用です。 |
Googleの料金ページには、動画が正常に生成された場合にのみ課金されることも記載されています。ただし、それによってリトライの記録が不要になるわけではありません。失敗した操作、変更されたプロンプト、またはユーザーによる再実行の要求によって、後で別の課金対象ジョブが発生する可能性があります。Veo API accessのチェックリストには、各リクエストごとの継続時間、解像度、バリアント、成功ステータス、リトライ回数を含めるべきです。
Veoを他のプロバイダーと比較する場合は、より広範なAI video generation API pricing comparisonを正規化のハブとして使用してください。実際のリクエスト形状を変換せずに、Veoの秒単位の行をトークン／リソースパック型のプロバイダーと直接比較してはいけません。
Veo の生成を長時間実行されるオペレーションとして扱う
Google の Veo ガイドでは、長時間実行されるオペレーションの流れが示されています。つまり、生成リクエストを送信し、オペレーションが完了するまでポーリングし、その後生成された動画を取得します。そのため、Veo API アクセス は通常の 1 回応答のテキストリクエストとは異なります。ルーターとダッシュボードは、最初の HTTP 呼び出しだけでなく、ポーリング全体にわたってジョブ状態を保持する必要があります。
本番対応のログは、次の質問に答えられる必要があります。
- どのアプリケーション、チームキー、環境、ワークフローが動画ジョブを作成したか？
- どの Veo モデル ID、アスペクト比、解像度、プロンプトタイプ、入力メディアが使用されたか？
- どのオペレーション ID、または同等の非同期ハンドルが返されたか？
- 完了または失敗までに何回ポーリングを行ったか？
- ジョブは成功、失敗、キャンセル、再試行、または別経路へのルーティングのいずれだったか？
- 生成された動画は何本返され、出力はどこに保存されたか？
- どの利用記録とコスト記録を後で経理が照合できるか？
ここはエンドポイント互換性の実地テストが必要になる箇所でもあります。ゲートウェイは多くのモデルファミリーに対して OpenAI 互換の base URL を公開できますが、動画生成ではプロバイダー固有のフィールドと非同期セマンティクスが必要になることがよくあります。現在の Flatkey キー、現在の Veo モデル行、そしてアプリケーションが実際に使用する正確なリクエスト本文をテストするまでは、コードスニペットをテンプレートとして扱ってください。
本番前にFlatkeyカタログ行を確認する
この記事のために、Flatkeyの公開価格カタログは2026年6月17日 Asia/Shanghai に確認されました。レスポンスには638のモデル行と価格バージョン a42d372ccf0b5dd13ecf71203521f9d2 が含まれていました。Veo関連の行も存在しており、veo-3.1-generate-preview、veo-3.1-fast-generate-preview、veo-3.1-lite-generate-preview、veo3.1、veo3.1-fast、veo3.1-pro といったGoogle風のIDやエイリアスが含まれていました。
重要な注意点として、そのスナップショットで確認したVeoの各行はすべて unknown_failure の可用性ステータスを示していました。つまり、この記事ではそれらの行を日時付きのカタログ証跡として使うことはできますが、本番利用可能だと主張してはいけません。正しい Veo API access の流れは、現在の Flatkey pricing page を開き、該当行を正確に確認し、ダッシュボード上のラベルを検証し、エンドポイントファミリーをチェックし、本番トラフィックを送る前に小さなスモークテストを実行することです。
| 確認したFlatkey行 | 見られたエンドポイントタイプ | 見られた料金フィールド | スナップショット時のステータス |
|---|---|---|---|
veo-3.1-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.4 |
unknown_failure |
veo-3.1-fast-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.15 |
unknown_failure |
veo-3.1-lite-generate-preview |
gemini, openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
veo3.1, veo3.1-fast, veo3.1-pro |
openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
Flatkeyの公開製品コピーは、慎重なルーティングの説明を裏付けています。つまり、1つのAPIキー、明確な価格設定、統合請求、キー・使用状況・ルーティングのためのダッシュボード、そして自動切り替え/負荷分散の表現です。ただし、実装上の証明はマーケティング上の約束よりも狭く捉えるべきです。 Veo API access については、受け入れテストはカタログ行だけではなく、ダッシュボードに裏付けられた実際のリクエスト記録であるべきです。
マルチプロバイダー動画ルーティングルールを設定する
動画のフェイルオーバーは、テキストのフェイルオーバーよりも繊細です。Veo ジョブが失敗した場合、別のプロバイダーに切り替えることで、再生時間、視覚スタイル、プロンプト解釈、コンテンツフィルター、出力形式、価格が変わる可能性があります。Veo API アクセスプランでは、自動フォールバックが安全なタイミングと、ワークフローを停止して人による確認に回すタイミングを定義すべきです。
| 状況 | 推奨ルーティング判断 | 理由 |
|---|---|---|
| 一時的なプロバイダーエラーまたはタイムアウト | 一度再試行するか、ワークフローで許可されている場合は承認済みの同等ルートに切り替えます。 | 繰り返しの失敗を隠さずに、ユーザー体験を保護します。 |
| 非推奨のモデル ID | ルートをブロックし、本番トラフィックの前に現在のモデルへ移行します。 | 停止日が確定しているルートへの、黙った依存を防ぎます。 |
| サポートされていないリクエストパラメータ | クローズドに失敗させ、クライアントのリクエストを修正します。 | 無条件のフォールバックでは、同じ不正なリクエストが別の場所で繰り返されるだけです。 |
| 高解像度の最終レンダリング | より高価なルートへのフォールバックには明示的な承認を要求します。 | 解像度と再生時間は、動画コストをすぐに押し上げます。 |
| ドラフトまたは社内向けのクリエイティブ反復 | 出力の差異が許容できる場合に限り、より低コストのフォールバックを許可します。 | ドラフトのワークフローは、顧客向け出力よりも多くの変動に耐えられます。 |
この判断の信頼性に関する側面は、AI API のロードバランシングとフェイルオーバー のプレイブックでより詳しく説明しています。動画では、すべてのフォールバック階層にコストとクリエイティブ出力の制約を追加してください。
ローンチ前にこのスモークテストを実行する
責任あるVeo API アクセスのスモークテストは、小さく、制御されており、検査しやすいものであるべきです:
- 本番以外のFlatkeyキーを作成または選択します。
- ライブ価格ページから現在のVeo行を1つ選び、その正確なモデルラベルを記録します。
- プロダクト/ドキュメントの担当者とエンドポイントファミリーとリクエストテンプレートを確認します。
- 既知の継続時間と解像度設定で、低リスクの動画ジョブを1件実行します。
- 操作ID、ステータスポーリングパス、最終結果、課金単位、および使用ログエントリを取得します。
- 可能であれば、ブロックされた非推奨モデルや未対応パラメータなど、制御された失敗を1回繰り返します。
- そのルートが本番トラフィック、ステージングのみ、または研究バックログのみのいずれに対応できるかを判断します。
これらの確認のいずれかが失敗した場合は、そのルートを本番から外したままにしてください。使用ログの欠落、料金単位の不明確さ、またはunknown_failureの可用性ステータスは、動画にとっては単なる書類上の問題ではありません。コスト、サポート、そして顧客の期待を変えてしまいます。
よくある質問
Veo APIアクセスを取得するにはどうすればよいですか？
まずGoogleの現在のGemini API Veoドキュメントと課金要件を確認し、そのうえで実装当日にモデルID、エンドポイント、料金を検証してください。ルーティングにFlatkeyを使う場合は、Veo APIアクセスを本番利用可能と見なす前に、現在の料金カタログとダッシュボードを確認してください。
どのVeoモデルIDを使うべきですか？
Googleの現在のVeo 3.1料金表には、veo-3.1-generate-preview、veo-3.1-fast-generate-preview、veo-3.1-lite-generate-previewが記載されています。新しい本番用途では、古いVeo 3.0およびVeo 2.0のIDは避けてください。Googleはそれらを2026年6月30日の終了対象として掲載しています。
Veo APIの料金はどのように計算されますか？
GoogleはVeo 3.1の有料ティア料金を秒単位で提示しており、バリアントや解像度によって料金が異なります。Veo APIアクセスでは、ルートをトークンベースまたはリソースパック型の動画プロバイダーと比較する前に、想定秒数、解像度、成功ポリシー、再試行を標準化してください。
Veoは他の動画生成モデルとルーティングできますか？
はい。ただし、ルート契約を定義した後に限ります。Veoから別の動画モデルへのフォールバックは、画質、再生時間、出力形式、モデレーション動作、コストを変える可能性があります。一般的な自動再試行ではなく、承認済みのフォールバックルールを使用してください。
Flatkeyユーザーは本番前に何を確認すべきですか？
現在のモデル行、エンドポイントファミリー、ダッシュボードのラベル、利用可能ステータス、価格ラベル、使用ログのフィールド、そして実際のスモークテスト結果を確認してください。この記事で使用した2026年6月17日のスナップショットでは、Veoの行は存在しましたがunknown_failureと表示されていたため、本番利用には最新の確認が必要です。
最終的なポイント
Veo API accessは、単なるプロバイダーのチェックボックスではなく、本番導入の判断事項です。公式モデルを確認し、秒数と解像度を正規化し、非同期ジョブを処理し、Flatkeyの現在の行とダッシュボード証跡を検証し、最初の顧客向け動画リクエストの前にフォールバックの境界を文書化してください。
Veoを他の動画モデルスタックと並べて評価するには、まず現在のFlatkey pricingカタログを確認し、上記のチェックリストを使って、どのルートがステージングに使えるか、どれにスモークテストが必要か、どれを調査バックログに残すべきかを判断してください。
