プレビュードキュメント

Veo 4 モデル API をプロダクトのワークフローに統合

この開発者ガイドでは、Veo 4 API の予定フローを説明します。動画タスク作成、ステータス確認、Webhook 受信、公開前のクレジット見積もりまで扱います。

API Keys を開く料金を見る

統合フロー

4 ステップで API を接続

バックエンド統合の準備に使える流れです。キーはサーバー側に保存し、ジョブは非同期で送信し、完了後に結果 URL を保存します。

API key を作成

Dashboard > API Keys を開き、サーバー用キーを準備します。ブラウザクライアントはキーを直接持たず、自分のバックエンドを呼び出してください。

動画タスクを送信

prompt、mode、アスペクト比、quality、任意の webhook URL を含めて text-to-video または image-to-video を送信します。

進捗を追跡

task_id で task endpoint をポーリングし、succeeded または failed まで確認します。Production では Webhook でポーリングを減らせます。

アセットを保存

成功したら video_url と thumbnail_url を CMS、エディタ、自動化パイプライン、ユーザープロジェクトに保存します。

プレビュー契約

予定されている REST インターフェース

以下の例は、チームが先にクライアント設計できるよう具体的にしています。正式ローンチまではドラフト契約として扱ってください。

Base URL

サーバーから HTTPS で呼び出します。ローンチ時には versioned domain や地域別 endpoint が追加される場合があります。

https://veo4api.net/api/video/veo4

認証

すべてのリクエストは Bearer token を使います。API keys は server secrets に保存し、公開 frontend bundle に入れないでください。

Authorization: Bearer YOUR_API_KEY

POSThttps://veo4api.net/api/video/veo4/generate変更の可能性あり

新しい非同期 Veo 4 動画タスクを作成します。レスポンスは task_id をすぐ返し、レンダリングはバックグラウンドで続きます。

フィールド	型	必須	説明
`prompt`	string	はい	生成クリップの自然言語指示。被写体、カメラ動作、スタイル、制約を含めます。
`image_urls`	string[]	いいえ	image-to-video ジョブで使う公開アクセス可能な元画像です。現在の proxy は image_urls と互換の画像 URL alias を受け付けます。
`aspect_ratio`	string	いいえ	予定値は 16:9、9:16、1:1 です。
`extend_task_id`	string	いいえ	動画延長ワークフローを要求する場合の、既存完了動画の任意 task_id。
`seeds`	number	いいえ	より再現しやすい出力のための任意の数値 seed。現在の範囲は 10000 から 99999 です。
`watermark`	string	いいえ	動画生成 backend に渡される任意の watermark ラベル。
`enableTranslation`	boolean	いいえ	生成前の prompt 翻訳を制御する任意の boolean。デフォルトは true です。
`public`	boolean	いいえ	結果が公開 showcase に表示され得るかを示す任意の boolean。

cURL

curl -X POST "https://veo4api.net/api/video/veo4/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic dolly shot of a glass greenhouse during sunrise",
    "aspect_ratio": "16:9",
    "watermark": "veo4api",
    "enableTranslation": true
  }'

JavaScript

const response = await fetch("https://veo4api.net/api/video/veo4/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "Animate this product photo into a smooth studio orbit shot",
    image_urls: ["https://cdn.example.com/input/product.png"],
    aspect_ratio: "1:1",
    seeds: 12345,
    public: false
  })
});

const data = await response.json();
console.log(data.task_id);

Queued レスポンス

{
  "task_id": "veo4_task_01j9example",
  "status": "queued",
  "model": "veo-4",
  "credits_estimated": 180,
  "created_at": "2026-05-17T08:00:00Z"
}

完了タスクレスポンス

{
  "task_id": "veo4_task_01j9example",
  "status": "succeeded",
  "progress": 100,
  "video_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.mp4",
  "thumbnail_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.jpg",
  "completed_at": "2026-05-17T08:03:42Z"
}

// Poll the task with:
// GET https://veo4api.net/api/video/veo4/status?task_id={task_id}

非同期配信

Webhook で完了イベントを受信

Webhook 配信は公開 API contract 向けの予定機能です。有効化までは status endpoint をポーリングし、将来の webhook_url フィールドに備えてください。

署名ポリシー

Webhook 署名の詳細は未確定です。将来の signature header 検証、task_id 保存、重複イベントの安全な無視を想定してください。

Webhook payload 例

{
  "event": "video.succeeded",
  "task_id": "veo4_task_01j9example",
  "status": "succeeded",
  "model": "veo-4",
  "video_url": "https://cdn.veo4api.net/results/veo4_task_01j9example.mp4",
  "credits_charged": 180,
  "created_at": "2026-05-17T08:00:00Z",
  "completed_at": "2026-05-17T08:03:42Z"
}

信頼性

タスク状態とエラー処理

明確なタスク状態と retry 可能な失敗を前提にクライアントを設計してください。生成は非同期なので、200 はタスク受付のみを意味します。

状態	意味
`queued`	リクエストは受け付けられ、容量待ちです。
`processing`	モデルが動画をレンダリングまたは後処理しています。
`succeeded`	動画が準備でき、結果 URL が利用できます。
`failed`	生成に失敗しました。エラーを表示し、prompt 修正や retry を許可してください。
`canceled`	完了前にタスクがキャンセルされました。

コード	推奨処理
`400`	retry 前に prompt length、image_urls、aspect_ratio、seeds、public visibility を検証してください。
`401`	API key がない、期限切れ、または無効です。新しいキー作成を案内してください。
`402`	クレジット不足です。Billing に送るか quality を下げて retry します。
`409`	タスクリクエストが競合しています。プラットフォームが conflict を返す場合は、既存タスクを取得してください。
`429`	Rate limit です。exponential backoff を使い、過度な polling を避けます。
`500`	一時的な platform または model エラーです。後で retry し、元のタスク記録を保持します。

クレジット計画

予定クレジット費用

現在の料金表示は Veo 4 容量の計画値としてこれらを使っています。ローンチまでは最終的な請求確約ではありません。

標準動画ジョブ

180

標準 Veo 4 動画生成 1 回あたりの推定クレジット。

HD 動画ジョブ

240

HD Veo 4 動画生成 1 回あたりの推定クレジット。

容量計画のみに使用してください。実際の API 制限、quality tier、課金動作は調整される可能性があります。