veo-video

Veo 動画生成

AceDataCloud の Google Veo API を通じて AI 動画を生成します。

セットアップ： トークンの設定については、認証を参照してください。

クイックスタート

curl -X POST https://api.acedata.cloud/veo/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "a whale breaching in slow motion at golden hour", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'

非同期： 非同期タスクのポーリングを参照してください。{"id": "..."} を指定して POST /veo/tasks でポーリングします。 これにより、タスク ID がすぐに返されます。結果を取得するにはポーリングします。

curl -X POST https://api.acedata.cloud/veo/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "<task_id from above>"}'

モデル

モデル	音声	最適な用途
veo3	あり（ネイティブ）	音声と映像を含む動画の生成
veo3-fast	あり（ネイティブ）	音声と映像を含む動画の高速生成
veo31	あり（ネイティブ）	Veo 3.1、最高品質
veo31-fast	あり（ネイティブ）	Veo 3.1 の高速版
veo31-fast-ingredients	あり（ネイティブ）	Veo 3.1 高速版、素材モード

ワークフロー

1. テキストから動画を生成

POST /veo/videos
{
  "action": "text2video",
  "prompt": "cinematic aerial shot of the Northern Lights over Iceland",
  "model": "veo3",
  "resolution": "1080p"
}

2. 画像から動画を生成

静止画像に動きを加えて動画にします。

POST /veo/videos
{
  "action": "image2video",
  "prompt": "the scene gently comes to life with wind and subtle motion",
  "image_urls": ["https://example.com/landscape.jpg"],
  "model": "veo31-fast",
  "aspect_ratio": "16:9"
}

3. 素材から動画を生成（複数画像の合成）

1～3 枚の参照画像を合成して動画を生成します（veo31-fast-ingredients のみ）。

POST /veo/videos
{
  "action": "ingredients2video",
  "image_urls": [
    "https://example.com/img1.jpg",
    "https://example.com/img2.jpg"
  ],
  "model": "veo31-fast-ingredients"
}

4. 1080p にアップスケール

以前に生成した動画をフル 1080p 解像度に変換します。

POST /veo/videos
{
  "action": "get1080p",
  "video_id": "your-video-id",
  "model": "veo3"
}

パラメーター

パラメーター	値	説明
action	"text2video", "image2video", "ingredients2video", "get1080p"	生成モード
model	モデルの表を参照	使用するモデル
resolution	"4k", "1080p", "gif"	出力解像度（デフォルト：720p）
aspect_ratio	"16:9", "9:16"	アスペクト比 — image2video でのみ有効
image_urls	文字列の配列	参照画像の URL — image2video の場合は最大 2 枚、ingredients2video の場合は最大 3 枚
video_id	文字列	アップスケールする動画 — get1080p でのみ使用
translation	true / false	プロンプトを英語に自動翻訳するかどうか（デフォルト：false）

注意点

• Veo 3 および 3.1 モデルはネイティブ音声を生成します
• get1080p アクションでは URL ではなく、以前の生成で取得した video_id を使用します
• aspect_ratio は image2video アクションでのみ有効です
• image_urls には配列を指定します — image2video では最大 2 枚、ingredients2video では最大 3 枚の画像を指定できます
• veo31-fast-ingredients では画像入力が必須です — テキストのみの生成には対応していません
• ドキュメントに記載されている aspect_ratio の値は "16:9" と "9:16" のみです
• translation: true を指定すると、Veo に送信する前に中国語などの英語以外のプロンプトが自動翻訳されます
• タスクのポーリングでは、/veo/tasks のリクエストボディに task_id ではなく id を使用します
• タスクの状態には "completed" ではなく "succeeded" が使われます — ポーリング時はこの値を確認してください

MCP： pip install mcp-veo | ホスト型：https://veo.mcp.acedata.cloud/mcp | すべての MCP サーバーを参照