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"}'
非同期: 非同期タスクポーリング を参照。
POST /veo/tasksで{"id": "..."}をポーリングします。 これによりすぐにタスク 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>"}'
モデル
| モデル | 音声 | 最適用途 |
|---|---|---|
veo2 | なし | コスト効率の良い生成 |
veo2-fast | なし | 高速でコスト効率の良い生成(デフォルト) |
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": "veo2",
"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 | モデル表参照 | 使用するモデル(デフォルト: veo2-fast) |
resolution | "4k", "1080p", "gif" | 出力解像度(デフォルト: 720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | アスペクト比 — image2video のみ有効 |
image_urls | 文字列配列 | 参照画像 URL — image2video(最大2枚)または ingredients2video(最大3枚)用 |
video_id | 文字列 | アップスケールする動画 — get1080p のみ |
translation | true / false | プロンプトを英語に自動翻訳(デフォルト: false) |
生成後エンドポイント
動画生成後、これらのエンドポイントでさらに加工できます:
アップサンプル (POST /veo/upsample)
生成した動画を 1080p、4K、または GIF にアップスケールします。
POST /veo/upsample
{
"video_id": "your-video-id",
"action": "4k"
}
| パラメータ | 値の例 | 説明 |
|---|---|---|
video_id | 文字列 | /veo/videos、/veo/extend、/veo/reshoot、または /veo/objects からのタスク ID |
action | "1080p", "4k", "gif" | アップサンプルターゲット |
延長 (POST /veo/extend)
既存の動画を続けて生成 — AI が自動的に次のセグメントを生成します。
POST /veo/extend
{
"video_id": "your-video-id",
"model": "veo31-fast",
"prompt": "the camera slowly zooms out"
}
| パラメータ | 値の例 | 説明 |
|---|---|---|
video_id | 文字列 | /veo/videos または以前の /veo/extend からのタスク ID |
model | "veo31-fast", "veo31" | Veo 3.1 シリーズのみ対応 |
prompt | 文字列 | オプション: 延長セグメントのガイド |
再撮影 (POST /veo/reshoot)
同じコンテンツを維持しながら新しいカメラモーションを適用して動画を再レンダリングします。
POST /veo/reshoot
{
"video_id": "your-video-id",
"motion_type": "LEFT_TO_RIGHT"
}
| パラメータ | 値の例 | 説明 |
|---|---|---|
video_id | 文字列 | /veo/videos からのタスク ID(/veo/extend の出力は不可) |
motion_type | 下記表参照 | 適用するカメラモーション |
motion_type 値:
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
オブジェクト (POST /veo/objects)
マスクベースのインペインティングを使用して、動画内のオブジェクトを挿入または削除します。
POST /veo/objects
{
"video_id": "your-video-id",
"action": "insert",
"prompt": "add a flying bird"
}
POST /veo/objects
{
"video_id": "your-video-id",
"action": "remove",
"image_mask": "https://example.com/mask.jpg"
}
| パラメータ | 値の例 | 説明 |
|---|---|---|
video_id | 文字列 | タスク ID(/veo/extend の出力は不可) |
action | "insert", "remove" | 操作タイプ |
prompt | 文字列 | insert には必須;remove にはオプション |
image_mask | 文字列 | URL または base64 JPEG — 白ピクセル = 対象領域。remove には必須;insert にはオプション |
注意点
- Veo 3 および 3.1 モデルは ネイティブ音声 を生成 —
veo2/veo2-fastは音声をサポートしません get1080pアクションはvideo_id(以前の生成から)を使用し、URL ではありませんaspect_ratioはimage2videoアクションのみ有効ですimage_urlsは配列を受け入れ —image2videoでは最大 2 枚、ingredients2videoでは最大 3 枚veo31-fast-ingredientsは画像入力を必須 — テキストのみの生成はできませんtranslation: trueは中国語やその他の非英語プロンプトを Veo に送信する前に自動翻訳します- タスクポーリングは
/veo/tasksのリクエストボディでid(task_idではない)を使用します - タスクステータスは
"succeeded"("completed" ではない)を使用 — ポーリング時にこの値を確認してください /veo/extendの出力は/veo/reshootまたは/veo/objectsの入力として使用できません
MCP:
pip install mcp-veo| ホスト:https://veo.mcp.acedata.cloud/mcp| すべての MCP サーバー を参照