Veo 3はGoogleのテキスト動画生成モデルで、Veo 3 APIはテキストプロンプトまたは静止画から、ネイティブで同期された音声付きのシネマティックなクリップを生成します。Kunavoでは、ファミリー全体(veo-3-lite、veo-3 Fast、veo-3-quality)をOpenAI形式の動画エンドポイント経由で、1つのベアラートークンにより提供しています。Googleの定価よりおよそ50–70%安価です。
Veo 3 APIを呼び出す
/app/keysでキーを生成し、/v1/video/generationsにPOSTします。生成には数分かかるため、同期呼び出しではクリップの準備が完了するまで接続が保持されます。
import requests
resp = requests.post(
"https://api.kunavo.com/v1/video/generations",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"model": "veo-3", # Fast tier; also veo-3-lite / veo-3-quality
"prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
"aspect_ratio": "16:9",
"resolution": "720p",
},
timeout=600, # Veo 3 generation takes minutes
)
print(resp.json()["data"][0]["url"])同じ呼び出しをcurlで行う場合:
curl https://api.kunavo.com/v1/video/generations \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
--max-time 600 \
-d '{
"model": "veo-3",
"prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
"aspect_ratio": "16:9",
"resolution": "720p"
}'コードベースの残りがすでにOpenAI SDKで動作しているなら、すべてに1つのクライアントを使い続けられます。チャット、画像、動画で同じキーとbase_urlを共有します。
# Already using the OpenAI SDK? Keep it — only base_url changes.
# Video isn't in the OpenAI SDK surface, so reuse its client for auth/config
# and post to the video route directly.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1",
)
resp = client.post(
"/video/generations",
body={"model": "veo-3", "prompt": "a neon-lit alley in the rain"},
cast_to=object,
options={"timeout": 600.0},
)
print(resp["data"][0]["url"])duration(秒数)は、秒単位課金のモデル(Seedanceの各モデルとWan 2.7)でクリップの長さを指定します。Veoモデルでは無視されます。Veoのクリップはすべて8秒で、動画単位で課金されます。
返されるURLは永続的です。完全なパラメータ(resolution、aspect_ratio、image_urls、image_mode)は動画APIリファレンスに記載されています。
Kunavoでは、Veoにはシードパラメータもネガティブプロンプトパラメータもありません。リクエストに含めても、そのパラメータは無視されます。
ティアと料金
Veo 3には3つの品質ティアがあります。以下の動画ごとの料金は、8秒・720pクリップの場合です。1080pと4Kでは料金が上がります。最新料金は各モデルページに掲載されています。
| モデル | Kunavo(720p / 8秒) | Google公式価格 | 最適な用途 |
|---|---|---|---|
| veo-3-lite | $0.18+ | $0.45 | ストーリーボード、プレビュー、大量処理 |
| veo-3(Fast) | $0.36+ | $1.20 | デフォルト — シネマティック映像+ネイティブ音声 |
| veo-3-quality | $1.60+ | $3.20 | キービジュアル、最高の忠実度 |
画像から動画
静止画をアニメーション化するにはimage_urlを渡します。商品やキャラクターの一貫性を保つのに便利です。制御されたトランジションには、最初と最後のフレームを渡します。
# Image-to-video: animate a still by passing image_url
requests.post(
"https://api.kunavo.com/v1/video/generations",
headers={"Authorization": f"Bearer {API_KEY}"},
json={
"model": "veo-3",
"prompt": "slow parallax, gentle wind through the grass",
"image_url": "https://your-cdn.com/keyframe.png",
},
timeout=600,
)本番環境では非同期処理
大規模運用で数分間の接続を保持しないでください。/v1/videosにタスクを送信し、タスクIDを取得してから、完了するまでGET /v1/videos/{id}をポーリングします。冪等性キーとオプションのWebhookも利用できます。完全な処理フローは動画ドキュメントにあります。
Veo 3へのプロンプト作成
- 被写体だけでなく、ショットを説明する — カメラワーク(ドリー、パン、プッシュイン)、レンズ感、照明、テンポが最も重要です。
- 音声を活用する — Veo 3は音声を生成するため、必要な環境音や効果音を指定しましょう。
- アスペクト比を明示する —
16:9は横長、9:16は縦長/ソーシャル向けです。 - Veoのクリップはすべて8秒 — 各ショットはこの長さに合わせて設計し、長いシーケンスには生成結果をつなぎ合わせます。
KunavoとGoogleへの直接接続の比較
Veo 3はGemini APIとVertex AIを通じてGoogleから直接利用することもできます。Google独自のSLAとサポート契約が必要なら、この方法が適しています。率直な比較は次のとおりです。
| Kunavo | Google直接(Gemini API / Vertex) | |
|---|---|---|
| セットアップ | 1つのキー、1つのbase_url | Google Cloudプロジェクト+請求先アカウント+IAM |
| 8秒・720pクリップあたりの料金 | $0.36+(Fastティア) | $1.20のリスト価格 |
| 料金 | 前払いウォレット、すべてのモデルで残高を共有 | GCP請求、サービスごとの明細 |
| 同じキーで使える他のモデル | Claude、GPT、画像、音楽モデル | Googleモデルのみ |
| キャパシティ | 共有 — 専用クォータがなく、上流の混雑がここにも影響します | 独自プロジェクトのクォータ。サポート経由で引き上げ可能 |
| サポート / SLA | メールサポート、契約上のSLAなし | Google Cloudのサポートプラン |
要約すると、セットアップ時間、単価、すべてのモダリティで1つのキーを使える点ではKunavoが優れています。クォータ保証やエンタープライズ契約が必要なら、Googleへの直接接続が適しています。
Veo 3とSora、Klingの比較
Veo 3は現在、一般提供されている中で最も強力なテキスト・動画モデルであり、Kunavoで利用できる唯一のモデルです。SoraとKlingは同じエンドポイントの背後でロードマップに含まれています。モデルの全体像はテキスト・動画APIガイドを、各ファミリーについてはSora APIおよびKling APIガイドをご覧ください。
このファミリーだけに絞らず、料金を基準に動画モデルを選びたいですか?動画生成API比較では、全8モデルの料金を同じ8秒・720pクリップの条件で比較しています。
よくある質問
Veo 3 APIとは?
Veo 3はGoogleのテキスト動画生成モデルです。Veo 3 APIでは、テキストプロンプトまたは静止画から、ネイティブで同期された音声付きのシネマティックなクリップを生成できます。Kunavoでは、OpenAI形式の/v1/video/generationsエンドポイントを、1つのベアラートークンで呼び出します。ティアはVeo 3 Lite、Veo 3 Fast、Veo 3 Qualityの3つです。
Veo 3 APIの料金はいくらですか?
KunavoではVeo 3は動画単位で課金され、Googleの定価より約50–70%安価です。8秒・720pのクリップ1本あたり、Veo 3 Liteは$0.18+、Veo 3 Fastは$0.36+、Veo 3 Qualityは$1.60+です。1080pと4Kはより高額です。失敗した生成には一切課金されません。
Veo 3は音声を生成しますか?
はい。Veo 3は動画と同時に、ネイティブで同期された音声(環境音、効果音、セリフ)を生成します。これは無音だった従来のテキスト動画生成モデルとの重要な違いです。
Veo 3 APIはGoogle経由よりKunavoの方が安いですか?
単価では、はい。Veo 3 Fastティアでは8秒・720pのクリップ1本あたり$0.36+で、Googleの定価$1.20より安価です。また、Google Cloudプロジェクトや請求アカウントを設定する必要もありません。トレードオフは、独自プロジェクトのクォータではなく共有容量を使うこと、契約上のSLAではなくメールサポートであることです。保証されたクォータが必要なら、Googleへ直接お問い合わせください。
Veo 3 APIキーを取得するにはどうすればよいですか?
登録し、/app/keysでキーを作成して、base_url=https://api.kunavo.com/v1を設定してください。Google Cloudプロジェクトは不要です。クイックスタートをご覧ください。