{ "aboutHtml": "

Veo 3.1は、テキストまたは画像主体の指示から短い映像・音声シーンを作るGoogleの動画生成モデルです。制作プロファイルはテキストから動画、画像から動画、開始・終了フレームのガイドによる制作、生成音、素材参照、独立した続きのフローに対応します。映画的なコンセプト、短い商品の物語、明確なシーン・動作・聴取体験を持つ映像区間に使えます。

最初に被写体と見える出来事を説明します。周囲、時刻、光を定め、カメラの視点や動き、意図した視覚スタイルを示します。独自の指示なら、暗いスタジオの台にガラス容器を置き、カメラがゆっくり横へ移動して反射を見せ、柔らかな環境音を添える場面にできます。各指示は完成結果で評価できる、見える・聞こえる特徴を与えます。

Googleの指示枠組みは、被写体、動作、シーン、カメラ、美的表現を別々の部分として扱います。すべての形容を加えず、ショットに役立つ部分を使います。文書化されたプロンプトプロファイルでは演出を英語で書きます。複数の動作がある場合はその関係を述べ、短いクリップに収まる量にして、何かを見せる演出や被写体の反応が分かりやすく伝わるようにします。

開始画像は冒頭の外観と構図を定めます。キャラクター、商品、場所が視覚素材としてすでにある場合に使い、そこから展開する動きを説明します。最後のフレームは終わりの目標構図を加えます。自然な遷移が伝わり、主被写体を識別する細部が保たれた境界フレームを準備し、生成後にフレーム間の動きを確認します。

素材参照は別の役割です。新しいシーンのキャラクターや物体の外観を導き、境界フレームはそのシーンの特定の瞬間を定めます。重要な視覚特徴を示す参照を選び、各素材の役割をプロンプトで明確にします。制作モデルの参照画像から動画の仕様は、そのフローを8秒出力とし、通常のテキスト主体の長さ選択とは別です。

通常の制作プロファイルは4・6・8秒、24fpsです。横16:9、縦9:16、プロンプトごと最大4本、出力720p、1080p、4Kで、形式はMP4です。画像主体の仕様はJPEGまたはPNG、入力画像最大20 MB、720p/1080p入力設定に対応します。使用先に合う出力プロファイルを選び、そのサイズで構図を読み取りやすくします。

ネイティブの音を見えるシーンに伴わせられます。同じ指示にせりふ、雰囲気、効果音を指定し、それぞれを生む被写体や出来事を示します。対話指示は演技、カメラ指示は観客への見せ方を定めます。クリップで実際に話せる時間に言葉を収め、明瞭さと動作との関係を確認します。

続きの制作には、メーカーの独立した動画延長フローがあります。適切な生成済み元クリップから始め、次に見える出来事やシーン変化を記述します。外観、動き、音のつなぎ目を確認できるよう、元と続きの区間を保存します。通常の新規生成の時間・解像度の選択を、すべての延長操作の普遍的な契約とみなしません。

ネガティブな説明は、タスクの視覚要件に除外を集中できます。商品バリエーションのシリーズでは被写体と構図を一定にし、照明やカメラ距離など創作上の方向を一つ変えます。プロンプト、参照、選択設定を結果とともに記録します。無関係な生成の集まりでなく、有用な創作差を比較できます。

通常のVeo 3.1制作プロファイルとVeo 3.1 Fastでは出力解像度が異なります。Fastは720pと1080p、通常3.1は4Kも挙げています。制作モデル識別子を古いPreviewや別世代へ黙って替えず、選択エディションを結果に添えます。被写体の外観も対応する操作も、選択フローに依存します。

生成はoperationとして行われ、完了結果から再生や後の編集用の動画素材が得られます。返されたファイルを元フレーム、参照素材、指示とともに保ち、付属するコンテンツ来歴情報も保存します。実際の各出力の被写体の外観、動作、構図、音、最終構成を確認します。選んだクリップを制作の構成要素にし、タイトル、トランジション、その他の仕上げを周囲の編集工程で加えます。

", "aboutText": "Veo 3.1は、テキストまたは画像主体の指示から短い映像・音声シーンを作るGoogleの動画生成モデルです。制作プロファイルはテキストから動画、画像から動画、開始・終了フレームのガイドによる制作、生成音、素材参照、独立した続きのフローに対応します。映画的なコンセプト、短い商品の物語、明確なシーン・動作・聴取体験を持つ映像区間に使えます。\n\n最初に被写体と見える出来事を説明します。周囲、時刻、光を定め、カメラの視点や動き、意図した視覚スタイルを示します。独自の指示なら、暗いスタジオの台にガラス容器を置き、カメラがゆっくり横へ移動して反射を見せ、柔らかな環境音を添える場面にできます。各指示は完成結果で評価できる、見える・聞こえる特徴を与えます。\n\nGoogleの指示枠組みは、被写体、動作、シーン、カメラ、美的表現を別々の部分として扱います。すべての形容を加えず、ショットに役立つ部分を使います。文書化されたプロンプトプロファイルでは演出を英語で書きます。複数の動作がある場合はその関係を述べ、短いクリップに収まる量にして、何かを見せる演出や被写体の反応が分かりやすく伝わるようにします。\n\n開始画像は冒頭の外観と構図を定めます。キャラクター、商品、場所が視覚素材としてすでにある場合に使い、そこから展開する動きを説明します。最後のフレームは終わりの目標構図を加えます。自然な遷移が伝わり、主被写体を識別する細部が保たれた境界フレームを準備し、生成後にフレーム間の動きを確認します。\n\n素材参照は別の役割です。新しいシーンのキャラクターや物体の外観を導き、境界フレームはそのシーンの特定の瞬間を定めます。重要な視覚特徴を示す参照を選び、各素材の役割をプロンプトで明確にします。制作モデルの参照画像から動画の仕様は、そのフローを8秒出力とし、通常のテキスト主体の長さ選択とは別です。\n\n通常の制作プロファイルは4・6・8秒、24fpsです。横16:9、縦9:16、プロンプトごと最大4本、出力720p、1080p、4Kで、形式はMP4です。画像主体の仕様はJPEGまたはPNG、入力画像最大20 MB、720p/1080p入力設定に対応します。使用先に合う出力プロファイルを選び、そのサイズで構図を読み取りやすくします。\n\nネイティブの音を見えるシーンに伴わせられます。同じ指示にせりふ、雰囲気、効果音を指定し、それぞれを生む被写体や出来事を示します。対話指示は演技、カメラ指示は観客への見せ方を定めます。クリップで実際に話せる時間に言葉を収め、明瞭さと動作との関係を確認します。\n\n続きの制作には、メーカーの独立した動画延長フローがあります。適切な生成済み元クリップから始め、次に見える出来事やシーン変化を記述します。外観、動き、音のつなぎ目を確認できるよう、元と続きの区間を保存します。通常の新規生成の時間・解像度の選択を、すべての延長操作の普遍的な契約とみなしません。\n\nネガティブな説明は、タスクの視覚要件に除外を集中できます。商品バリエーションのシリーズでは被写体と構図を一定にし、照明やカメラ距離など創作上の方向を一つ変えます。プロンプト、参照、選択設定を結果とともに記録します。無関係な生成の集まりでなく、有用な創作差を比較できます。\n\n通常のVeo 3.1制作プロファイルとVeo 3.1 Fastでは出力解像度が異なります。Fastは720pと1080p、通常3.1は4Kも挙げています。制作モデル識別子を古いPreviewや別世代へ黙って替えず、選択エディションを結果に添えます。被写体の外観も対応する操作も、選択フローに依存します。\n\n生成はoperationとして行われ、完了結果から再生や後の編集用の動画素材が得られます。返されたファイルを元フレーム、参照素材、指示とともに保ち、付属するコンテンツ来歴情報も保存します。実際の各出力の被写体の外観、動作、構図、音、最終構成を確認します。選んだクリップを制作の構成要素にし、タイトル、トランジション、その他の仕上げを周囲の編集工程で加えます。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cb9f1ed0e99d0ccb950f4f859767e414854f9f15ea9a3dc52ce2c5c21f9e0642", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ja", "methods": [ { "html": "
G

Google: Veo 3.1

Google /google/veo-3.1

はじめに

Veo 3.1は、生成音声、境界フレームのガイド、参照素材を使う、テキスト・画像主体のシーン向けGoogle動画モデルです。制作プロファイルは24fpsの4・6・8秒クリップを提供し、720p、1080p、4Kを選べます。

対応する入力
テキスト
結果
動画
モデルについて

この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。

Veo 3.1は、テキストまたは画像主体の指示から短い映像・音声シーンを作るGoogleの動画生成モデルです。制作プロファイルはテキストから動画、画像から動画、開始・終了フレームのガイドによる制作、生成音、素材参照、独立した続きのフローに対応します。映画的なコンセプト、短い商品の物語、明確なシーン・動作・聴取体験を持つ映像区間に使えます。

最初に被写体と見える出来事を説明します。周囲、時刻、光を定め、カメラの視点や動き、意図した視覚スタイルを示します。独自の指示なら、暗いスタジオの台にガラス容器を置き、カメラがゆっくり横へ移動して反射を見せ、柔らかな環境音を添える場面にできます。各指示は完成結果で評価できる、見える・聞こえる特徴を与えます。

Googleの指示枠組みは、被写体、動作、シーン、カメラ、美的表現を別々の部分として扱います。すべての形容を加えず、ショットに役立つ部分を使います。文書化されたプロンプトプロファイルでは演出を英語で書きます。複数の動作がある場合はその関係を述べ、短いクリップに収まる量にして、何かを見せる演出や被写体の反応が分かりやすく伝わるようにします。

開始画像は冒頭の外観と構図を定めます。キャラクター、商品、場所が視覚素材としてすでにある場合に使い、そこから展開する動きを説明します。最後のフレームは終わりの目標構図を加えます。自然な遷移が伝わり、主被写体を識別する細部が保たれた境界フレームを準備し、生成後にフレーム間の動きを確認します。

素材参照は別の役割です。新しいシーンのキャラクターや物体の外観を導き、境界フレームはそのシーンの特定の瞬間を定めます。重要な視覚特徴を示す参照を選び、各素材の役割をプロンプトで明確にします。制作モデルの参照画像から動画の仕様は、そのフローを8秒出力とし、通常のテキスト主体の長さ選択とは別です。

通常の制作プロファイルは4・6・8秒、24fpsです。横16:9、縦9:16、プロンプトごと最大4本、出力720p、1080p、4Kで、形式はMP4です。画像主体の仕様はJPEGまたはPNG、入力画像最大20 MB、720p/1080p入力設定に対応します。使用先に合う出力プロファイルを選び、そのサイズで構図を読み取りやすくします。

ネイティブの音を見えるシーンに伴わせられます。同じ指示にせりふ、雰囲気、効果音を指定し、それぞれを生む被写体や出来事を示します。対話指示は演技、カメラ指示は観客への見せ方を定めます。クリップで実際に話せる時間に言葉を収め、明瞭さと動作との関係を確認します。

続きの制作には、メーカーの独立した動画延長フローがあります。適切な生成済み元クリップから始め、次に見える出来事やシーン変化を記述します。外観、動き、音のつなぎ目を確認できるよう、元と続きの区間を保存します。通常の新規生成の時間・解像度の選択を、すべての延長操作の普遍的な契約とみなしません。

ネガティブな説明は、タスクの視覚要件に除外を集中できます。商品バリエーションのシリーズでは被写体と構図を一定にし、照明やカメラ距離など創作上の方向を一つ変えます。プロンプト、参照、選択設定を結果とともに記録します。無関係な生成の集まりでなく、有用な創作差を比較できます。

通常のVeo 3.1制作プロファイルとVeo 3.1 Fastでは出力解像度が異なります。Fastは720pと1080p、通常3.1は4Kも挙げています。制作モデル識別子を古いPreviewや別世代へ黙って替えず、選択エディションを結果に添えます。被写体の外観も対応する操作も、選択フローに依存します。

生成はoperationとして行われ、完了結果から再生や後の編集用の動画素材が得られます。返されたファイルを元フレーム、参照素材、指示とともに保ち、付属するコンテンツ来歴情報も保存します。実際の各出力の被写体の外観、動作、構図、音、最終構成を確認します。選んだクリップを制作の構成要素にし、タイトル、トランジション、その他の仕上げを周囲の編集工程で加えます。

Ailootで利用可能 · 入力とメソッド

Ailoot Ultra · 動画 POST /v1/videos
入力の種類
text
出力の種類
video
出力形式
mp4
出力数
最大 4 出力s
フィールド種類要件値と制限デフォルト
フィールドmodel種類string要件必須値と制限
google/veo-3.1
デフォルト—
フィールド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"]}, {"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 トークン
設定Ultra料金表—予測数量指定された設定（概算のみ）。音声を生成音声あり解像度720p課金単位出力動画1秒あたり課金条件—料金
出力 · 出力動画の推定秒数 · 比較専用の見積もり $0.8 出力動画1秒あたり

表示された単価は、生成前の費用見積もりに使用します。最終請求額は、元の生成に記録された費用から算出されます。動画の実際の再生時間は、課金対象の数量ではありません。

設定動画料金料金表—予測数量—音声を生成—解像度—課金単位動画1秒あたり課金条件音声：with_audio；解像度：4k料金
出力 · 動画料金 · 比較専用の見積もり $1.2 動画1秒あたり
設定Ultra料金表—予測数量指定された設定（概算のみ）。音声を生成音声なし解像度720p課金単位出力動画1秒あたり課金条件—料金
出力 · 出力動画の推定秒数 · 比較専用の見積もり $0.4 出力動画1秒あたり

表示された単価は、生成前の費用見積もりに使用します。最終請求額は、元の生成に記録された費用から算出されます。動画の実際の再生時間は、課金対象の数量ではありません。

設定動画料金料金表—予測数量—音声を生成—解像度—課金単位動画1秒あたり課金条件音声：without_audio；解像度：4k料金
出力 · 動画料金 · 比較専用の見積もり $0.8 動画1秒あたり
設定生成費用の見積もり料金表—予測数量生成1回分の概算音声を生成—解像度—課金単位—課金条件—料金
出力 · 推定生成コスト · 比較専用の見積もり $1.6 生成前の見積もり

この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。

Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →

参考料金の詳細

モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。

動画設定の料金参照情報

設定別の価格

各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。

設定課金条件料金
設定動画料金課金条件音声：with_audio料金
出力 · 動画料金 $0.8 動画1秒あたり

表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。

設定動画料金課金条件音声：with_audio；解像度：4k料金
出力 · 動画料金 $1.2 動画1秒あたり

表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。

設定動画料金課金条件音声：without_audio料金
出力 · 動画料金 $0.4 動画1秒あたり

表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。

設定動画料金課金条件音声：without_audio；解像度：4k料金
出力 · 動画料金 $0.8 動画1秒あたり

表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。

リクエスト例

Ailoot Ultra · 動画

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/veo-3.1", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

結果を受け取って保存

Ailoot Ultra · 動画

mp4

ジョブのステータスを確認
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
その他のコンテンツ取得
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
完了した結果をすべて保存

完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセット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

メソッドパスのエイリアス

/v1/videos/generations, /videos, /videos/generations

関連する呼び出し用ID

google/veo-3.1

", "method_identity": { "effective_request_model_id": "google/veo-3.1", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "google/veo-3.1", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|google%2Fveo-3.1", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Keep every completed data[] signed owned URL and the full status metadata. Save every output, including its generated audio.", "errors": [ { "code": null, "condition": "動画プロファイルの解析前に、未加工のリクエスト本文の読み取りに失敗します", "http_status": 400, "recovery": "返されたレスポンスを保持し、読み取りできないリクエスト本文を修正してください。", "type": "invalid_request_error" }, { "code": null, "condition": "正確な動画プロファイルを解析できないか、解析済みの完全なプロファイルに一致する利用可能な料金表がありません", "http_status": 422, "message": "The complete video request cannot be priced", "recovery": "レスポンスを保持してください。利用が許可された正確で完全なプロファイルと、その公開料金表を使用します。この分岐は、プロバイダーへの送信前に実行されます。", "type": "price_unavailable" }, { "code": null, "condition": "元の結果のコンテンツはまだ利用できません", "http_status": 409, "recovery": "元の返却IDをポーリングし、Retry-Afterに従ってください。", "type": "video_not_ready" }, { "code": null, "condition": "返されたレスポンスは、操作または結果の確認が必要であることを示しています", "http_status": null, "recovery": "最初に返された操作／タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。", "type": "server_error" }, { "absent_fields": [ "status", "object", "model", "data" ], "code": "result_pending_check", "condition": "元のステータス／コンテンツをGETで取得する際、タスクが未公開で、元のジョブがfailed/cancelled/expiredのいずれでもなく、ローカル状態がunknownまたは元のジョブのステータスがcompletedである場合。", "friendly_fields": "error.reason=result_pending_check,error.param=null; error.operation_id and error.request_id when the existing context supplies them. error.message is rewritten/localized.", "headers": { "Retry-After": null, "X-Should-Retry": "false" }, "http_status": 503, "recovery": "元のidとoperation_id（同じ公開動画ID）、レスポンス、ヘッダーを保持してください。元のステータス／コンテンツだけを読み取ってください。新しい生成リクエストは決して送信しないでください。", "response_fields": { "charge_pending_check": true, "error.code": "result_pending_check", "error.type": "server_error", "id": "original public video ID", "operation_id": "same as id" }, "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "既存の元のジョブを読み取ってください。結果不明の送信を決して再実行しないでください。", "unknown_no_replay": true }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_video", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "Use actual returned task_id or original public video id from response/media library. On HTTP503 result_pending_check from original video status/content GET, operation_id equals that original public video id. Do not assume unrelated operation IDs name media tasks.", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_results": "完了したdata[]にある所有動画の署名付きURLと、ステータスメタデータ全体を保持してください。生成された音声も含めて、すべての出力を保存します。generate_audio=falseでも有効なAAC音声トラックが含まれる場合があります。その音声を含む元のMP4全体を保持してください。", "create_status": 202, "family": "video", "fields": [ { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "data[]", "type": "signed content URL" }, { "description": null, "name": "charge_pending_check", "type": "boolean" }, { "description": null, "name": "error.code", "type": "string" }, { "description": null, "name": "error.message", "type": "string" }, { "description": "HTTP503 result_pending_checkの元のステータス／コンテンツのレスポンス：idは同じ元の公開動画IDです。", "name": "operation_id", "type": "string" }, { "description": "HTTP503のresult_pending_checkではserver_errorが返されます。", "name": "error.type", "type": "string" } ], "format": "mp4", "maximum_outputs": 4, "status_enum": [ "in_progress", "completed", "failed" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/veo-3.1" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 6, 8 ], "enum_known": true, "name": "duration", "required": true, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": true, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "all fields outside the exact required six-key profile", "image or reference inputs", "1080p or 4K" ] }, "hints": [ "完全なレスポンスと元の返却IDを保持してください。", "結果不明の作成リクエストは、決して再送信しないでください。" ], "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text" ], "parameters": [ { "enum": [ "google/veo-3.1" ], "name": "model", "required": true, "type": "string" }, { "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "enum": [ 4, 6, 8 ], "name": "duration", "required": true, "type": "integer" }, { "enum": [ "720p" ], "name": "resolution", "required": true, "type": "string" }, { "enum": [ "16:9", "9:16" ], "name": "aspect_ratio", "required": true, "type": "string" }, { "enum": [ false, true ], "name": "generate_audio", "required": true, "type": "boolean" } ], "required": [ "model", "prompt", "duration", "resolution", "aspect_ratio", "generate_audio" ] }, "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "Read existing original job; never resubmit unknown send.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "operation_modes": [ "text_to_video" ], "output": { "family": "video", "format": "mp4", "max_outputs": 4, "priced_duration": "Video-file duration is not the billing quantity; final charge follows the actual billed configuration." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "生成費用の見積もり", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"google/veo-3.1\", \"prompt\": \"a calm greenhouse\", \"duration\": 6, \"resolution\": \"720p\", \"aspect_ratio\": \"16:9\", \"generate_audio\": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · exact configured profile", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [ "Keep the complete response and the original returned IDs.", "Never resubmit an unknown creation." ], "http": "POST", "in": null, "input": [ "text" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "google/veo-3.1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{request_id}", "GET /v1/videos/generations/{request_id}", "GET /v1/videos/{request_id}/content", "GET /v1/videos/generations/{request_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "google/veo-3.1", "nativeProvenance": { "input_facts_canonical_sha256": "afd83f6f163695cd06917b6415c9e1784bc199a45caa62c9bbf15bfbb30b516f", "input_html_sha256": "89a364bff771ee29ec91bb096498be6861bfadf932c71e94492d8cdcc5ecc12b", "private_audit_sha256": "bdf21f0c33b10c6b46c238b6797fc2899e1a4b365a8384bc8124d6d58a3b7bec", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ja/google-veo-3-1/", "description": "Veo 3.1は、生成音声、境界フレームのガイド、参照素材を使う、テキスト・画像主体のシーン向けGoogle動画モデルです。制作プロファイルは24fpsの4・6・8秒クリップを提供し、720p、1080p、4Kを選べます。", "locale": "ja", "md_url": "https://ailoot.ai/models/ja/google-veo-3-1/index.md", "title": "Google: Veo 3.1 — Ailoot", "url": "https://ailoot.ai/models/ja/google-veo-3-1/" }, "rawModel": { "about": "Veo 3.1は、テキストまたは画像主体の指示から短い映像・音声シーンを作るGoogleの動画生成モデルです。制作プロファイルはテキストから動画、画像から動画、開始・終了フレームのガイドによる制作、生成音、素材参照、独立した続きのフローに対応します。映画的なコンセプト、短い商品の物語、明確なシーン・動作・聴取体験を持つ映像区間に使えます。\n\n最初に被写体と見える出来事を説明します。周囲、時刻、光を定め、カメラの視点や動き、意図した視覚スタイルを示します。独自の指示なら、暗いスタジオの台にガラス容器を置き、カメラがゆっくり横へ移動して反射を見せ、柔らかな環境音を添える場面にできます。各指示は完成結果で評価できる、見える・聞こえる特徴を与えます。\n\nGoogleの指示枠組みは、被写体、動作、シーン、カメラ、美的表現を別々の部分として扱います。すべての形容を加えず、ショットに役立つ部分を使います。文書化されたプロンプトプロファイルでは演出を英語で書きます。複数の動作がある場合はその関係を述べ、短いクリップに収まる量にして、何かを見せる演出や被写体の反応が分かりやすく伝わるようにします。\n\n開始画像は冒頭の外観と構図を定めます。キャラクター、商品、場所が視覚素材としてすでにある場合に使い、そこから展開する動きを説明します。最後のフレームは終わりの目標構図を加えます。自然な遷移が伝わり、主被写体を識別する細部が保たれた境界フレームを準備し、生成後にフレーム間の動きを確認します。\n\n素材参照は別の役割です。新しいシーンのキャラクターや物体の外観を導き、境界フレームはそのシーンの特定の瞬間を定めます。重要な視覚特徴を示す参照を選び、各素材の役割をプロンプトで明確にします。制作モデルの参照画像から動画の仕様は、そのフローを8秒出力とし、通常のテキスト主体の長さ選択とは別です。\n\n通常の制作プロファイルは4・6・8秒、24fpsです。横16:9、縦9:16、プロンプトごと最大4本、出力720p、1080p、4Kで、形式はMP4です。画像主体の仕様はJPEGまたはPNG、入力画像最大20 MB、720p/1080p入力設定に対応します。使用先に合う出力プロファイルを選び、そのサイズで構図を読み取りやすくします。\n\nネイティブの音を見えるシーンに伴わせられます。同じ指示にせりふ、雰囲気、効果音を指定し、それぞれを生む被写体や出来事を示します。対話指示は演技、カメラ指示は観客への見せ方を定めます。クリップで実際に話せる時間に言葉を収め、明瞭さと動作との関係を確認します。\n\n続きの制作には、メーカーの独立した動画延長フローがあります。適切な生成済み元クリップから始め、次に見える出来事やシーン変化を記述します。外観、動き、音のつなぎ目を確認できるよう、元と続きの区間を保存します。通常の新規生成の時間・解像度の選択を、すべての延長操作の普遍的な契約とみなしません。\n\nネガティブな説明は、タスクの視覚要件に除外を集中できます。商品バリエーションのシリーズでは被写体と構図を一定にし、照明やカメラ距離など創作上の方向を一つ変えます。プロンプト、参照、選択設定を結果とともに記録します。無関係な生成の集まりでなく、有用な創作差を比較できます。\n\n通常のVeo 3.1制作プロファイルとVeo 3.1 Fastでは出力解像度が異なります。Fastは720pと1080p、通常3.1は4Kも挙げています。制作モデル識別子を古いPreviewや別世代へ黙って替えず、選択エディションを結果に添えます。被写体の外観も対応する操作も、選択フローに依存します。\n\n生成はoperationとして行われ、完了結果から再生や後の編集用の動画素材が得られます。返されたファイルを元フレーム、参照素材、指示とともに保ち、付属するコンテンツ来歴情報も保存します。実際の各出力の被写体の外観、動作、構図、音、最終構成を確認します。選んだクリップを制作の構成要素にし、タイトル、トランジション、その他の仕上げを周囲の編集工程で加えます。", "alias_of": null, "aliases": [], "author": "Google", "available": null, "canonical_model": "google/veo-3.1", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "構成の料金情報はすべて詳細で確認できます。" } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "5c12291f0ed9f66144eb670a", "label": "動画設定の料金参照情報", "profiles": [ { "basis": "表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。", "dimensions": { "conditions": "音声：with_audio" }, "label": "動画料金", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。", "dimensions": { "conditions": "音声：with_audio；解像度：4k" }, "label": "動画料金", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。", "dimensions": { "conditions": "音声：without_audio" }, "label": "動画料金", "units": [ { "amount": "0.4", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。", "dimensions": { "conditions": "音声：without_audio；解像度：4k" }, "label": "動画料金", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "google/veo-3.1", "input": [ "text" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Keep every completed data[] signed owned URL and the full status metadata. Save every output, including its generated audio.", "errors": [ { "code": null, "condition": "動画プロファイルの解析前に、未加工のリクエスト本文の読み取りに失敗します", "http_status": 400, "recovery": "返されたレスポンスを保持し、読み取りできないリクエスト本文を修正してください。", "type": "invalid_request_error" }, { "code": null, "condition": "正確な動画プロファイルを解析できないか、解析済みの完全なプロファイルに一致する利用可能な料金表がありません", "http_status": 422, "message": "The complete video request cannot be priced", "recovery": "レスポンスを保持してください。利用が許可された正確で完全なプロファイルと、その公開料金表を使用します。この分岐は、プロバイダーへの送信前に実行されます。", "type": "price_unavailable" }, { "code": null, "condition": "元の結果のコンテンツはまだ利用できません", "http_status": 409, "recovery": "元の返却IDをポーリングし、Retry-Afterに従ってください。", "type": "video_not_ready" }, { "code": null, "condition": "返されたレスポンスは、操作または結果の確認が必要であることを示しています", "http_status": null, "recovery": "最初に返された操作／タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。", "type": "server_error" }, { "absent_fields": [ "status", "object", "model", "data" ], "code": "result_pending_check", "condition": "元のステータス／コンテンツをGETで取得する際、タスクが未公開で、元のジョブがfailed/cancelled/expiredのいずれでもなく、ローカル状態がunknownまたは元のジョブのステータスがcompletedである場合。", "friendly_fields": "error.reason=result_pending_check,error.param=null; error.operation_id and error.request_id when the existing context supplies them. error.message is rewritten/localized.", "headers": { "Retry-After": null, "X-Should-Retry": "false" }, "http_status": 503, "recovery": "元のidとoperation_id（同じ公開動画ID）、レスポンス、ヘッダーを保持してください。元のステータス／コンテンツだけを読み取ってください。新しい生成リクエストは決して送信しないでください。", "response_fields": { "charge_pending_check": true, "error.code": "result_pending_check", "error.type": "server_error", "id": "original public video ID", "operation_id": "same as id" }, "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "既存の元のジョブを読み取ってください。結果不明の送信を決して再実行しないでください。", "unknown_no_replay": true }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_video", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "Use actual returned task_id or original public video id from response/media library. On HTTP503 result_pending_check from original video status/content GET, operation_id equals that original public video id. Do not assume unrelated operation IDs name media tasks.", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_results": "完了したdata[]にある所有動画の署名付きURLと、ステータスメタデータ全体を保持してください。生成された音声も含めて、すべての出力を保存します。generate_audio=falseでも有効なAAC音声トラックが含まれる場合があります。その音声を含む元のMP4全体を保持してください。", "create_status": 202, "family": "video", "fields": [ { "description": null, "name": "id", "type": "string" }, { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "data[]", "type": "signed content URL" }, { "description": null, "name": "charge_pending_check", "type": "boolean" }, { "description": null, "name": "error.code", "type": "string" }, { "description": null, "name": "error.message", "type": "string" }, { "description": "HTTP503 result_pending_checkの元のステータス／コンテンツのレスポンス：idは同じ元の公開動画IDです。", "name": "operation_id", "type": "string" }, { "description": "HTTP503のresult_pending_checkではserver_errorが返されます。", "name": "error.type", "type": "string" } ], "format": "mp4", "maximum_outputs": 4, "status_enum": [ "in_progress", "completed", "failed" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/veo-3.1" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 6, 8 ], "enum_known": true, "name": "duration", "required": true, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": true, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "all fields outside the exact required six-key profile", "image or reference inputs", "1080p or 4K" ] }, "hints": [ "完全なレスポンスと元の返却IDを保持してください。", "結果不明の作成リクエストは、決して再送信しないでください。" ], "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text" ], "parameters": [ { "enum": [ "google/veo-3.1" ], "name": "model", "required": true, "type": "string" }, { "max_utf8_bytes": 10000, "name": "prompt", "non_whitespace": true, "required": true, "type": "string" }, { "enum": [ 4, 6, 8 ], "name": "duration", "required": true, "type": "integer" }, { "enum": [ "720p" ], "name": "resolution", "required": true, "type": "string" }, { "enum": [ "16:9", "9:16" ], "name": "aspect_ratio", "required": true, "type": "string" }, { "enum": [ false, true ], "name": "generate_audio", "required": true, "type": "boolean" } ], "required": [ "model", "prompt", "duration", "resolution", "aspect_ratio", "generate_audio" ] }, "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "parameters": [ { "availability": "source_interface", "conditions": "Must be less than the actual returned output count.", "default": 0, "default_known": true, "enum": null, "enum_known": false, "maximum": null, "maximum_known": false, "minimum": 0, "name": "index", "required": false, "type": "integer" } ], "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET. On HTTP503 result_pending_check from original status/content GET, operation_id equals id: use that same original public video ID for polling. Do not substitute unrelated operation IDs from other responses.", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "owned_result": { "http": "GET", "path": "/v1/media/assets/{asset_id}" }, "status": [ { "http": "GET", "path": "/v1/videos/{request_id}" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}" } ], "submit_status": 202, "unknown": "Read existing original job; never resubmit unknown send.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "operation_modes": [ "text_to_video" ], "output": { "family": "video", "format": "mp4", "max_outputs": 4, "priced_duration": "Video-file duration is not the billing quantity; final charge follows the actual billed configuration." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "生成費用の見積もり", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"google/veo-3.1\", \"prompt\": \"a calm greenhouse\", \"duration\": 6, \"resolution\": \"720p\", \"aspect_ratio\": \"16:9\", \"generate_audio\": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · exact configured profile", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [ "Keep the complete response and the original returned IDs.", "Never resubmit an unknown creation." ], "http": "POST", "in": null, "input": [ "text" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [ "/v1/videos/generations", "/videos", "/videos/generations" ], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": true, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: with_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.", "dimensions": { "forecast_quantity": "Requested configuration; estimate only.", "generate_audio": false, "quoted_unit": "per output video second", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" } ] }, { "dimensions": { "conditions": "audio: without_audio; resolution: 4k", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "google/veo-3.1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{request_id}", "GET /v1/videos/generations/{request_id}", "GET /v1/videos/{request_id}/content", "GET /v1/videos/generations/{request_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "1.2", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_with_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio", "label": "Estimated output video second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "public_unit_label": "per output video second", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_video_second" }, { "amount": "0.8", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds_without_audio_4k", "label": "Video price", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "google/veo-3.1", "request_model_id": "google/veo-3.1", "route_label": "Ultra" } ], "name": "Google: Veo 3.1", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.6, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.6, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "720p" }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_second", "conditions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "720p" }, "key": "output_video_audio", "label": "output video audio", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "1080p" }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_second", "conditions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "1080p" }, "key": "output_video_audio", "label": "output video audio", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "4k" }, "label": "Ultra", "units": [ { "amount": "1.20", "amount_unit": "usd_per_output_second", "conditions": { "audio": true, "native_model_id": "veo-3.1-generate-preview", "resolution": "4k" }, "key": "output_video_audio", "label": "output video audio", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "basis": "audio=true", "billing_original_currency": "USD", "billing_original_rate": "0.80", "key": "duration_seconds_with_audio", "label": "output second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "1.2", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=4k · audio=true Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "1.20", "key": "duration_seconds_with_audio_4k", "label": "output second", "native_amount_usd_per_unit": "1.2", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.4", "amount_unit": "usd_per_exact_physical_unit", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.40", "key": "duration_seconds_without_audio", "label": "output second", "native_amount_usd_per_unit": "0.4", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.8", "amount_unit": "usd_per_exact_physical_unit", "basis": "resolution=4k · audio=false Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.80", "key": "duration_seconds_without_audio_4k", "label": "output second", "native_amount_usd_per_unit": "0.8", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "google/veo-3.1", "short": "Veo 3.1は、生成音声、境界フレームのガイド、参照素材を使う、テキスト・画像主体のシーン向けGoogle動画モデルです。制作プロファイルは24fpsの4・6・8秒クリップを提供し、720p、1080p、4Kを選べます。" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Veo 3.1は、生成音声、境界フレームのガイド、参照素材を使う、テキスト・画像主体のシーン向けGoogle動画モデルです。制作プロファイルは24fpsの4・6・8秒クリップを提供し、720p、1080p、4Kを選べます。", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "fad3cc2d4e30fbafd8d918cdb1eba5c94942a5d40ef1f61830267db8cfd5fad2", "renderer_sha256": "b06e5309d3e585ab5fe0535c1a8bd6320bdc357ea8509c2389320e8fa40c36e5" }, "sourceRevision": "968029abee62152e5d9084337c511b03114f9ccd4145351a2eb9a00d80ce09c0" }