Veo 3.1 API ドキュメント
Google の AI 動画生成をアプリケーションに統合するための完全ガイド。
クイックスタートガイド
数分で Veo 3.1 API を使い始められます。
1
APIキーを取得
まずダッシュボードから API キーを取得してください。
2
最初のリクエストを送信
1curl -X POST "https://veo3api.com/generate" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "prompt": "a dog running",
6 "model": "veo3-fast",
7 "watermark": "veo"
8 }'
3
生成ステータスを確認
動画生成は非同期です。ステータスを確認するには https://veo3api.com/feed エンドポイントを使用するか、
cURL
1curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
2 -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_KEYPOST
https://veo3api.com/generateテキストまたは画像プロンプトから動画を生成
リクエストボディ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
prompt | string | * | 動画生成用のテキストプロンプト |
model | string | * | veo3（高品質、180 クレジット）または veo3-fast（高速生成、25 クレジット）を選択 |
aspect_ratio | string | アスペクト比：16:9（デフォルト、1080P HD）、9:16（縦向き）、または Auto（画像に合わせる） | |
image_urls | string[] | 画像から動画を生成するための画像 URL 配列 | |
watermark | string | カスタム透かしテキスト。透かしなしの場合は null に設定 |
リクエスト例
JSON
1{
2 "prompt": "a dog running",
3 "model": "veo3-fast",
4 "watermark": "veo"
5}
レスポンス
JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
6 }
7}
クレジット消費
| モデルタイプ | クレジット | コスト |
|---|---|---|
veo3-fast | 25 credits | $0.25 |
veo3 | 180 credits | $1.80 |
extend | 元の動画と同じ | - |
get-1080p | 無料 | $0.00 |
注意：クレジットは動画生成が正常に完了した場合のみ差し引かれます。失敗したタスクではクレジットは消費されません。
GET
https://veo3api.com/feed動画生成タスクのステータスを確認
リクエスト例
GET https://veo3api.com/feed?task_id=YOUR_TASK_IDレスポンス
JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "request": {
6 "prompt": "a dog running",
7 "model": "veo3-fast",
8 "watermark": "veo"
9 },
10 "response": [
11 "https://cdn.veo3api.com/video/example_watermarked.mp4"
12 ],
13 "status": "COMPLETED",
14 "created_at": "2025-10-29 12: 20: 46"
15 }
16}
💡 ヒント：生成された動画の URL は data.response 配列から取得できます。
POST
https://veo3api.com/extend新しいプロンプトで既存の動画を拡張します。拡張された動画は元の動画の終了地点から続行されます。
リクエストボディ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
task_id | string | * | 拡張する元の完了済み動画の task_id |
prompt | string | * | 動画をどのように続行／拡張するかを記述するテキストプロンプト |
seeds | integer | 再現可能な生成のための乱数シード（10000-99999）。同じシードで類似した結果が得られます | |
watermark | string | カスタム透かしテキスト。透かしなしの場合は null に設定 |
リクエスト例
JSON
1{
2 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
3 "prompt": "The dog continues running and jumps over a fence",
4 "watermark": "veo"
5}
レスポンス
JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
6 "original_task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
7 "credits_consumed": 25
8 }
9}
注意：拡張できるのは完了した動画タスクのみです。1080P に変換された動画は拡張できません。
GET
https://veo3api.com/get-1080p無料完了した動画タスクの高解像度 1080P 版を取得します。このエンドポイントは無料で、クレジットを消費しません。
リクエスト例
GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_IDレスポンス
JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
6 "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
7 }
8}
💡 ヒント：このエンドポイントは完全に無料です。完了した動画であれば、クレジットを消費せずに 1080P 版を取得できます。
HTTP ステータスコード
| ステータスコード | 説明 |
|---|---|
200 | リクエスト成功 |
400 | 不正なリクエスト - パラメータが無効 |
401 | 未認証 - API キーが無効 |
429 | レート制限超過 |
500 | サーバー内部エラー |