Veo 3.1 API ドキュメント

Google の AI 動画生成をアプリケーションに統合するための完全ガイド。

クイックスタートガイド

数分で Veo 3.1 API を使い始められます。

APIキーを取得

まずダッシュボードから API キーを取得してください。

最初のリクエストを送信

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo4",
    "duration": 5,
    "resolution": "720p"
  }'

生成ステータスを確認

動画生成は非同期です。ステータスを確認するには https://veo3api.com/feed エンドポイントを使用するか、

cURL

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

API リファレンス

Veo 3.1 API のすべてのエンドポイント、パラメータ、レスポンス形式の完全なリファレンス。

ベース URL

https://veo3api.com

エンドポイントには /api プレフィックスはありません。https://veo3api.com/ を呼び出してください（例：https://veo3api.com/generate）。

認証

すべての API リクエストは、Authorization ヘッダーに Bearer トークンを指定して認証する必要があります。

Authorization: Bearer YOUR_API_KEY

POSThttps://veo3api.com/generate

テキストまたは画像プロンプトから動画を生成

リクエストボディ

パラメータ	タイプ	必須	説明
`prompt`	string	*	動画生成用のテキストプロンプト
`model`	string	*	veo3（高品質、180 クレジット）、veo3-fast（高速生成、25 クレジット）、または veo4（長さと解像度に応じた料金。下表参照）を選択
`duration`	integer		Veo 4 の長さ：5、10、15 秒（デフォルト：5 秒）
`resolution`	string		Veo 4 の出力解像度：480p、720p（デフォルト）、1080p
`aspect_ratio`	string		アスペクト比：16:9（デフォルト、1080P HD）、9:16（縦向き）、または Auto（画像に合わせる）
`image_urls`	string[]		画像から動画を生成するための画像 URL 配列
`watermark`	string		カスタム透かしテキスト。透かしなしの場合は null に設定

リクエスト例

JSON

{
  "prompt": "a dog running",
  "model": "veo4",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16: 9"
}

レスポンス

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n90a1b2c3d4e5f6sd20",
    "status": "IN_PROGRESS",
    "consumed_credits": 240,
    "model": "veo4"
  }
}

クレジット消費

モデルタイプ	クレジット	コスト
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`veo4`480p · 5s / 10s / 15s	160 / 320 / 480 credits	$1.60 / $3.20 / $4.80
`veo4`720p · 5s / 10s / 15s	240 / 480 / 720 credits	$2.40 / $4.80 / $7.20
`veo4`1080p · 5s / 10s / 15s	360 / 720 / 1080 credits	$3.60 / $7.20 / $10.80
`extend`	元の動画と同じ	-
`get-1080p`	無料	$0.00

Veo 4 の料金は動画の長さと解像度で決まり、テキスト生成と画像生成は同じ料金です。

注意：クレジットは動画生成が正常に完了した場合のみ差し引かれます。失敗したタスクではクレジットは消費されません。

GEThttps://veo3api.com/feed

動画生成タスクのステータスを確認

リクエスト例

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

レスポンス

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo4",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16: 9"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "consumed_credits": 240,
    "type": "text-to-video",
    "model": "veo4",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

💡 ヒント：生成された動画の URL は data.response 配列から取得できます。

POSThttps://veo3api.com/extend

新しいプロンプトで既存の動画を拡張します。拡張された動画は元の動画の終了地点から続行されます。

リクエストボディ

パラメータ	タイプ	必須	説明
`task_id`	string	*	拡張する元の完了済み動画の task_id
`prompt`	string	*	動画をどのように続行／拡張するかを記述するテキストプロンプト
`seeds`	integer		再現可能な生成のための乱数シード（10000-99999）。同じシードで類似した結果が得られます
`watermark`	string		カスタム透かしテキスト。透かしなしの場合は null に設定

リクエスト例

JSON

{
  "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

レスポンス

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

注意：このエンドポイントは完了した veo3 および veo3-fast タスクのみをサポートします。Veo 4 タスクには使用できず、1080P に変換された動画も拡張できません。

GEThttps://veo3api.com/get-1080p無料

完了した動画タスクの高解像度 1080P 版を取得します。このエンドポイントは無料で、クレジットを消費しません。

リクエスト例

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

レスポンス

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 ヒント：このエンドポイントは完了した veo3 および veo3-fast タスクのみをサポートします。無料でクレジットは消費しません。Veo 4 は作成時に 1080p を直接選択できます。

HTTP ステータスコード

ステータスコード	説明
`200`	リクエスト成功
`400`	不正なリクエスト - パラメータが無効
`401`	未認証 - API キーが無効
`429`	レート制限超過
`500`	サーバー内部エラー