ガイド一覧へ戻る
動画·2026年7月2日·最終更新 2026年10月9日·読了7分

Veo 3.1 API — ネイティブ音声対応のGoogleテキスト・動画変換、OpenAI互換(2026年)

Veo 3.1はネイティブ音声に対応したGoogleのテキストから動画を生成するモデルです。KunavoでVeo 3.1 APIを呼び出す方法、3つのティア、画像から動画への生成、Googleの定価より約50〜70%安い動画単位の料金、非同期ワークフローを説明します。

最終確認日:。

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します。生成には数分かかるため、同期呼び出しではクリップの準備が完了するまで接続が保持されます。

veo3.py
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で行う場合:

veo3.sh
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を共有します。

veo3_openai_sdk.py
# 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.py
# 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とサポート契約が必要なら、この方法が適しています。率直な比較は次のとおりです。

KunavoGoogle直接(Gemini API / Vertex)
セットアップ1つのキー、1つのbase_urlGoogle 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プロジェクトは不要です。クイックスタートをご覧ください。