Google: Veo 3.1 Fast
Veo 3.1 Fastは、テキストや画像主体の短いシーンを生成音付きで作るGoogleの動画モデルです。制作プロファイルは720pまたは1080p、24fpsで4・6・8秒のMP4を返し、開始・終了フレームをガイドに使えます。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Veo 3.1 Fastは、テキストで説明した、または画像で定めた短いシーン向けのGoogleの高速動画生成プロファイルです。映像ショットと生成音を組み合わせ、開始・終了フレームのガイドに対応します。シーン案の開発、短い創作バリエーション、明確な動作と視覚方針を持つコンパクトな音声付き映像に使えます。
被写体、動作、場所を中心に指示を組み立てます。その後、ショットに役立つ構図、カメラ移動、照明、見た目の処理を加えます。独自の商品指示なら、木の机の小さな陶器のランプへゆっくり近づき、灯りがつくと静かなスイッチ音が鳴る場面にできます。被写体と見える出来事は画を、音の指示は聴取体験を説明します。
メーカーのプロンプトプロファイルに従い、シーンの演出は英語で書きます。クリップ長に合う主動作にし、カメラ移動と被写体の動きを区別します。ワイドな導入、質感のクローズアップ、動く物体を追うショットは、それぞれ別の創作課題に答えます。短いショットへ無関係なカメラ指示を組み合わせず、意図した細部を伝える視点を選びます。
画像主体のシーンでは、外観と構図がすでに定まった明瞭な開始画像を準備します。動きの指示はその後の出来事に集中できます。終了フレームは遷移の視覚的な到達点になります。両フレームで重要な被写体の細部とスタイルを一貫させ、または意図する変換を明示します。冒頭と末尾だけでなく遷移自体を確認します。
メーカーの制作プロファイルは4・6・8秒、横16:9または縦9:16、一つのプロンプトにつき動画最大4本です。Fastは720pまたは1080p、24fps、MP4です。画像主体の仕様はJPEGまたはPNG、最大入力20 MB、720p/1080p入力設定に対応します。意図した向きに構図を整え、画像枠内に入力を収めます。
音も生成シーンの一部にできます。見える動作とともに、せりふ、環境音、関連効果を記述し、話す被写体や音を生む出来事を特定します。対話は演技に収まる短さにし、雰囲気や音楽と区別します。音声生成は文章のシーン指示に従い、録音音声はこのプロファイルの通常入力として文書化されていません。
現行の制作プロファイルは素材参照生成と動画延長も挙げています。参照は被写体や物体の外観を導き、境界フレームは冒頭・末尾の構図を導きます。すべての画像を交換可能な制御とみなさず、役割が明確な参照を選びます。続きのクリップは独立した延長フローを選び、既存動作の後に何が起きるかを述べます。入力処理は新しいテキスト主体のショットと異なります。
ネガティブな説明で、避けたい内容や視覚処理を示せます。主プロンプトは求めるシーンに集中させ、除外はタスクに固有のものにします。商品バリエーションでは被写体と構図を保ち、光の向きや素材の処理など一つの細部を変えます。比較では設定と参照一式を保持し、創作上の差を明確にします。
Veo 3.1 Fastと通常のVeo 3.1は別の選択肢です。Fastの文書化された制作出力は720p/1080pで、通常版には4Kもあります。Preview識別子や別のVeo版を自動的な同義語とせず、選択したエディションと出力設定を素材に添えます。
フローは生成operationを作成し、完了後に生成された動画ファイルを取得できるようにします。レビューに選んだ実際の出力をすべて、指示、元フレーム、関連設定とともに保存します。operation識別子は生成の記録で、再生して編集に使えるのは完成MP4です。付属するコンテンツ来歴メタデータも保存します。
クリップ全体で被写体の外観、要求動作、カメラ演出、音を確認します。長い構成に使う前に、対話の明瞭さと音・見える出来事の関係を確認します。コンセプトショット、商品を見せるショット、短い物語区間として使い、後のタイトル、トランジション、その他の編集を周囲の制作フローで加えます。
Ailoot Ultra · 動画 POST /v1/videos google/veo-3.1-fast
google/veo-3.1-fastはじめに
Veo 3.1 Fastは、テキストや画像主体の短いシーンを生成音付きで作るGoogleの動画モデルです。制作プロファイルは720pまたは1080p、24fpsで4・6・8秒のMP4を返し、開始・終了フレームをガイドに使えます。
- 対応する入力
- テキスト
- 結果
- 動画
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 動画 POST /v1/videos
- 入力の種類
text- 出力の種類
video- 出力形式
- mp4
- 出力数
- 最大 4 出力s
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 google/veo-3.1-fast | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 最大UTF-8バイト数: 10,000 空白以外の文字が必須: はい | デフォルト— |
フィールドduration | 種類integer | 要件必須 | 値と制限 4, 6, 8 | デフォルト— |
フィールドresolution | 種類string | 要件必須 | 値と制限 720p | デフォルト— |
フィールドaspect_ratio | 種類string | 要件必須 | 値と制限 16:9, 9:16 | デフォルト— |
フィールドgenerate_audio | 種類boolean | 要件必須 | 値と制限 false, true | デフォルト— |
入力素材の組み合わせ
テキストから動画へ · 必須: prompt
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, prompt, duration, resolution, aspect_ratio, generate_audio |
パラメータadditional_properties | 仕様false |
パラメータparameters | 仕様{"name":"model","type":"string","required":true,"enum":["google/veo-3.1-fast"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
パラメータmaterial_types | 仕様text |
メソッドのエイリアス: /v1/videos/generations, /videos, /videos/generations
ライフサイクル: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
完全なレスポンスと元の返却IDを保持してください。
結果不明の作成リクエストは、決して再送信しないでください。
料金
最終料金の計算方法
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値(default)を使用する場合
比較用の推定料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 音声を生成 | 解像度 | 課金単位 | 課金条件 | 料金 |
|---|---|---|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 音声を生成— | 解像度— | 課金単位— | 課金条件— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定動画料金 | 料金表— | 予測数量— | 音声を生成— | 解像度— | 課金単位動画1秒あたり | 課金条件音声:with_audio | 料金 出力 · 動画料金 · 比較専用の見積もり $0.24 動画1秒あたり |
| 設定動画料金 | 料金表— | 予測数量— | 音声を生成— | 解像度— | 課金単位動画1秒あたり | 課金条件音声:with_audio;解像度:4k | 料金 出力 · 動画料金 · 比較専用の見積もり $0.6 動画1秒あたり |
| 設定Ultra | 料金表— | 予測数量指定された設定(概算のみ)。 | 音声を生成音声あり | 解像度720p | 課金単位出力動画1秒あたり | 課金条件— | 料金 出力 · 出力動画の推定秒数 · 比較専用の見積もり $0.2 出力動画1秒あたり 表示料金は生成前の費用見積もりです。最終料金は元の生成処理に記録された費用から計算します。動画の実時間は課金数量ではありません。 |
| 設定動画料金 | 料金表— | 予測数量— | 音声を生成— | 解像度— | 課金単位動画1秒あたり | 課金条件音声:without_audio | 料金 出力 · 動画料金 · 比較専用の見積もり $0.2 動画1秒あたり |
| 設定動画料金 | 料金表— | 予測数量— | 音声を生成— | 解像度— | 課金単位動画1秒あたり | 課金条件音声:without_audio;解像度:4k | 料金 出力 · 動画料金 · 比較専用の見積もり $0.5 動画1秒あたり |
| 設定Ultra | 料金表— | 予測数量指定された設定(概算のみ)。 | 音声を生成音声なし | 解像度720p | 課金単位出力動画1秒あたり | 課金条件— | 料金 出力 · 出力動画の推定秒数 · 比較専用の見積もり $0.16 出力動画1秒あたり 表示された単価は、生成前の費用見積もりに使用します。最終請求額は、元の生成に記録された費用から算出されます。動画の実際の再生時間は、課金対象の数量ではありません。 |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 音声を生成— | 解像度— | 課金単位— | 課金条件— | 料金 出力 · 推定生成コスト · 比較専用の見積もり $0.64 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
参考料金の詳細
モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。
動画設定の料金参照情報
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 課金条件 | 料金 |
|---|---|---|
| 設定動画料金 | 課金条件音声:with_audio | 料金 出力 · 動画料金 $0.24 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
| 設定動画料金 | 課金条件音声:with_audio;解像度:4k | 料金 出力 · 動画料金 $0.6 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
| 設定動画料金 | 課金条件音声:without_audio | 料金 出力 · 動画料金 $0.2 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
| 設定動画料金 | 課金条件音声:with_audio;解像度:720p | 料金 出力 · 動画料金 $0.2 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
| 設定動画料金 | 課金条件音声:without_audio;解像度:4k | 料金 出力 · 動画料金 $0.5 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
| 設定動画料金 | 課金条件音声:without_audio;解像度:720p | 料金 出力 · 動画料金 $0.16 動画1秒あたり 表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。 |
リクエスト例
Ailoot Ultra · 動画
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1-fast", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
結果を受け取って保存
Ailoot Ultra · 動画
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
ジョブのステータスを確認
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
その他のコンテンツ取得
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
完了した結果をすべて保存
完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。
完了したdata[]にある所有動画の署名付きURLと、ステータスメタデータ全体を保持してください。生成された音声も含めて、すべての出力を保存します。generate_audio=falseでも有効なAAC音声トラックが含まれる場合があります。その音声を含む元のMP4全体を保持してください。
元のレスポンスを確認する場合
既存の元のジョブを読み取ってください。結果不明の送信を決して再実行しないでください。
最大出力数: 4.
レスポンスのフィールド
| フィールド | 種類 | 意味 |
|---|---|---|
フィールドid | 種類string | 意味— |
フィールドobject | 種類string | 意味— |
フィールドmodel | 種類string | 意味— |
フィールドstatus | 種類string | 意味— |
フィールドdata[] | 種類signed content URL | 意味— |
フィールドcharge_pending_check | 種類boolean | 意味— |
フィールドerror.code | 種類string | 意味— |
フィールドerror.message | 種類string | 意味— |
フィールドoperation_id | 種類string | 意味HTTP503 result_pending_checkの元のステータス/コンテンツのレスポンス:idは同じ元の公開動画IDです。 |
フィールドerror.type | 種類string | 意味HTTP503のresult_pending_checkではserver_errorが返されます。 |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件動画プロファイルの解析前に、未加工のリクエスト本文の読み取りに失敗します | 次の手順返されたレスポンスを保持し、読み取りできないリクエスト本文を修正してください。 |
レスポンス422 · price_unavailable | 条件正確な動画プロファイルを解析できないか、解析済みの完全なプロファイルに一致する利用可能な料金表がありません | 次の手順レスポンスを保持してください。利用が許可された正確で完全なプロファイルと、その公開料金表を使用します。この分岐は、プロバイダーへの送信前に実行されます。 |
レスポンス409 · video_not_ready | 条件元の結果のコンテンツはまだ利用できません | 次の手順元の返却IDをポーリングし、Retry-Afterに従ってください。 |
レスポンスserver_error | 条件返されたレスポンスは、操作または結果の確認が必要であることを示しています | 次の手順最初に返された操作/タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。 |
レスポンス503 · result_pending_check | 条件元のステータス/コンテンツをGETで取得する際、タスクが未公開で、元のジョブがfailed/cancelled/expiredのいずれでもなく、ローカル状態がunknownまたは元のジョブのステータスがcompletedである場合。 | 次の手順元のidとoperation_id(同じ公開動画ID)、レスポンス、ヘッダーを保持してください。元のステータス/コンテンツだけを読み取ってください。新しい生成リクエストは決して送信しないでください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra google/veo-3.1-fast
メソッドパスのエイリアス
/v1/videos/generations, /videos, /videos/generations
関連する呼び出し用ID
FAQ · Google: Veo 3.1 Fast
- 利用できる入力と結果は何ですか?
POST /v1/videos·google/veo-3.1-fast:text→video- リクエストはどの項目を使用しますか?
POST /v1/videos·google/veo-3.1-fast:model,prompt,duration,resolution,aspect_ratio,generate_audio