メインコンテンツへスキップ
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "action": "generate",
    "prompt": "A golden retriever running on a beach at sunset, cinematic lighting, slow motion",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo-3.1",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
非同期処理モード — リクエスト送信後にタスク ID が返されます。タスクステータス照会 インターフェースで生成結果を取得してください。動画リンクの有効期限は24時間です。速やかにダウンロードしてください。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "action": "generate",
    "prompt": "A golden retriever running on a beach at sunset, cinematic lighting, slow motion",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo-3.1",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
利用可能なモデル

モデル ID説明
veo-3.1VEO 3.1、4K・ネイティブ音声に対応
veo-3.1-fastVEO 3.1 高速版
veo-3.0VEO 3.0

​
統一パラメータ

​
model
string
必須
モデル ID
​
action
string
デフォルト:"generate"
操作タイプ
​
prompt
string
必須
動画の説明テキスト。VEO 3+ ではプロンプト内で効果音やセリフを記述でき、モデルが自動的に対応する音声を生成します
​
aspect_ratio
string
デフォルト:"16:9"
アスペクト比：16:9、9:16
​
duration
integer
デフォルト:"8"
動画の長さ（秒）：4、6、8
​
resolution
string
デフォルト:"720p"
出力解像度、選択可能な値はモデルにより異なります。各モデルの Tab を参照
​
negative_prompt
string
表示させたくない内容を直接記述してください（否定文は使用しないでください）
​
seed
integer
ランダムシード、再現性を向上（完全一致は保証されません）。VEO 3.1 シリーズのみ対応
​
callback_url
string
Webhook コールバックアドレス
​
extra
object
Google VEO にパススルーされる追加パラメータ、各モデルの Tab を参照

​
モデル固有のパラメータ

resolution の選択可能な値： 720p、1080p、4k
​
extra.personGeneration
string
デフォルト:"allow_all"
人物生成の制御：
  • allow_all — 全ての人物を許可
  • allow_adult — 成人のみ許可
  • dont_allow — 人物生成を禁止
固有の機能：
  • ネイティブ音声生成（セリフ + 環境音 + 効果音、追加パラメータ不要）
  • 4K 解像度出力

​
制約条件

条件要件
解像度 1080p または 4kduration は 8 である必要があります
解像度 4kVEO 3.1 および 3.1 Fast のみ対応
出力フレームレート24 FPS
出力フォーマットMP4
VEO 3+ はネイティブで音声生成に対応しており、追加パラメータは不要です。プロンプト内で効果音を記述するだけです（例：“the sound of waves crashing”）。

​
レスポンス

​
task_id
string
タスク ID
​
model
string
使用されたモデル ID
​
action
string
操作タイプ
​
status
string
タスクステータス：queued
​
created_at
integer
作成時間（Unix ミリ秒タイムスタンプ）
​
progress
integer
進捗、初期値は 0