{ "aboutHtml": "

google/omni-1.1-flash 可選 4、6、8、10 秒，必填 360p 或 720p，以及 aspect_ratio 的 VIDEO_ASPECT_RATIO_LANDSCAPE 或 VIDEO_ASPECT_RATIO_PORTRAIT。可做短直式商品預告，在 prompt 指定主體及可見動作。

提交 /v1/videos/generations，收集原工作結果。n、count 限一個輸出請求，未列圖片參考。因此是有界短片流程，不是任意長度編輯器。Flash 不保證延遲，完成收集時應保留實際回傳的每個輸出。

", "aboutText": "google/omni-1.1-flash 可選 4、6、8、10 秒，必填 360p 或 720p，以及 aspect_ratio 的 VIDEO_ASPECT_RATIO_LANDSCAPE 或 VIDEO_ASPECT_RATIO_PORTRAIT。可做短直式商品預告，在 prompt 指定主體及可見動作。 提交 /v1/videos/generations，收集原工作結果。n、count 限一個輸出請求，未列圖片參考。因此是有界短片流程，不是任意長度編輯器。Flash 不保證延遲，完成收集時應保留實際回傳的每個輸出。", "editorialOverlay": { "copy_fields": { "about_html": "

google/omni-1.1-flash 可選 4、6、8、10 秒，必填 360p 或 720p，以及 aspect_ratio 的 VIDEO_ASPECT_RATIO_LANDSCAPE 或 VIDEO_ASPECT_RATIO_PORTRAIT。可做短直式商品預告，在 prompt 指定主體及可見動作。

提交 /v1/videos/generations，收集原工作結果。n、count 限一個輸出請求，未列圖片參考。因此是有界短片流程，不是任意長度編輯器。Flash 不保證延遲，完成收集時應保留實際回傳的每個輸出。

", "short_text": "文字轉影片，可選 4／6／8／10 秒、360p／720p，必選直式或橫式。" }, "copy_sha256": "f496aa1381f2b0f184b2ed811d0c0199468ec0cac9f8856799ed525d70bd4e38", "copy_source": { "locale": "zh-hant-tw", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/omni-1.1-flash", "source_facts_sha256": "a4e28c352d38e6990904dfc6d51eddc6b358e67ad9fcfb09e7dfb723d46be236", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "1295390baf5346c85bb4e3914c1eee1cca3113b896072479bcc0cdb8372e34dd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "zh-hant-tw", "methods": [ { "html": "
G

Omni 1.1 Flash

Google /google/omni-1.1-flash

入門

文字轉影片，可選 4／6／8／10 秒、360p／720p，必選直式或橫式。

接受的輸入
文字
結果
影片
關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

google/omni-1.1-flash 可選 4、6、8、10 秒，必填 360p 或 720p，以及 aspect_ratio 的 VIDEO_ASPECT_RATIO_LANDSCAPE 或 VIDEO_ASPECT_RATIO_PORTRAIT。可做短直式商品預告，在 prompt 指定主體及可見動作。

提交 /v1/videos/generations，收集原工作結果。n、count 限一個輸出請求，未列圖片參考。因此是有界短片流程，不是任意長度編輯器。Flash 不保證延遲，完成收集時應保留實際回傳的每個輸出。

Ailoot 可用 · 輸入與方法

Ailoot · 影片 POST /v1/videos/generations
輸入
text
輸出
video
輸出格式
mp4
欄位類型要求值與限制預設值
欄位model類型string要求必填值與限制
google/omni-1.1-flash
預設值—
欄位prompt類型string要求必填值與限制
長度下限: 1
預設值—
欄位duration類型integer要求替代選項之一必填值與限制
4, 6, 8, 10
替代選項: duration_s；若同時提供兩個欄位，其值必須一致
符合以下條件時必填: 未提供 duration_s
至少一項必填: duration, duration_s
單位: 秒
預設值—
欄位duration_s類型integer要求選填值與限制
4, 6, 8, 10
替代選項: duration
單位: 秒
預設值—
欄位resolution類型string要求必填值與限制
360p, 720p
預設值—
欄位aspect_ratio類型string要求必填值與限制
VIDEO_ASPECT_RATIO_LANDSCAPE, VIDEO_ASPECT_RATIO_PORTRAIT
預設值—
欄位n類型integer要求選填值與限制
1
預設值1
欄位count類型integer要求選填值與限制
1
適用條件: 若也提供 n，值必須一致
預設值—
輸入素材組合

文字生成影片 · 必填： prompt

方法參數與生命週期
參數規格
參數material_types規格text
參數required規格null
參數optional_controls規格null

生命週期： 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 均為精確值；供應商能力與准入狀態分開。

方案

Ailoot 方法費率

Ailoot 影片POST /v1/videos/generations
輸出
US$0.03 360p 每秒

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

請求範例

Ailoot · 影片

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"model": "google/omni-1.1-flash", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

接收並儲存結果

Ailoot · 影片

mp4

查看工作狀態
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY"
其他內容讀取方式
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" \\\n  --output video.mp4
保留所有已完成的結果

請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 URL 取得素材。

data[] 包含所有回傳的內容路徑；content_url 僅代表第一個輸出

需要檢查原始回應時

請讀取現有的原始作業；切勿重新提交傳送結果不明的請求。

錯誤與後續步驟
回應條件下一步
回應400 · invalid_request_error條件必要的 prompt/resolution/aspect/duration 缺漏或無效下一步提交新的請求前，請先修正無效的請求欄位。
回應409 · video_not_ready條件原始影片內容尚無法取得下一步請輪詢原始回傳的 ID，並遵守 Retry-After。
回應503 · server_error條件結果需要查核下一步請保留原始 ID 與請求紀錄憑證；切勿重新建立此操作。
回應server_error條件回傳的回應表示該作業或結果需要檢查下一步保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。

別名

模型別名

Ailoot google/omni-1.1-flash, omni-featured

方法路徑別名

請使用上方列出的 API 方法路徑。

相關呼叫用 ID

google/omni-1.1-flash, omni-featured

", "method_identity": { "effective_request_model_id": "google/omni-1.1-flash", "fmt": "videos", "http": "POST", "path": "/v1/videos/generations", "request_model_id": "google/omni-1.1-flash", "route_label": "Core" }, "method_key": "Core|videos|/v1/videos/generations|google%2Fomni-1.1-flash", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "data[] 包含所有回傳的內容路徑；content_url 僅代表第一個輸出", "errors": [ { "condition": "必要的 prompt/resolution/aspect/duration 缺漏或無效", "http_status": 400, "recovery": "提交新的請求前，請先修正無效的請求欄位。", "type": "invalid_request_error" }, { "condition": "原始影片內容尚無法取得", "http_status": 409, "recovery": "請輪詢原始回傳的 ID，並遵守 Retry-After。", "type": "video_not_ready" }, { "condition": "結果需要查核", "http_status": 503, "recovery": "請保留原始 ID 與請求紀錄憑證；切勿重新建立此操作。", "type": "server_error" }, { "code": null, "condition": "回傳的回應表示該作業或結果需要檢查", "http_status": null, "recovery": "保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos/generations" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "operation_id_is_not_task_id": true, "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": [ { "mode": "text_to_video", "optional": [], "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": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_outputs": "data[] contains all returned content paths; content_url is first only", "content_selection": "The Core content handler serves the primary video. Fetch every actual status.data[] path for all outputs; no indexed content query is implemented by this handler.", "create_fields": [ "id", "object", "model", "status", "duration_s", "resolution" ], "create_status": 202, "family": "video", "format": "mp4", "pending_status": "in_progress", "retry_after_pending_seconds": 10, "status_enum": [ "in_progress", "completed" ], "status_fields": [ "id", "object", "model", "status", "duration_s", "resolution", "content_url", "data", "partial", "content_revoked", "result_pending_check" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "google/omni-1.1-flash" ], "enum_known": true, "enum_status": "specified", "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": null, "enum_known": false, "enum_status": "not_specified", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "alternative": "duration_s；若同時提供兩個欄位，其值必須一致", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration", "required": false, "required_any_of": [ "duration", "duration_s" ], "required_when": "未提供 duration_s", "type": "integer", "unit": "秒" }, { "alternative": "duration", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration_s", "required": false, "type": "integer", "unit": "秒" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "360p", "720p" ], "enum_known": true, "enum_status": "specified", "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "VIDEO_ASPECT_RATIO_LANDSCAPE", "VIDEO_ASPECT_RATIO_PORTRAIT" ], "enum_known": true, "enum_status": "specified", "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "default_status": "specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "count", "required": false, "type": "integer", "when": "若也提供 n，值必須一致" } ], "required_parameter_combinations": [ [ "model", "prompt", "duration", "resolution", "aspect_ratio" ], [ "model", "prompt", "duration_s", "resolution", "aspect_ratio" ] ], "unsupported": [] }, "hints": [ "方法結構與 ID 均為精確值；供應商能力與准入狀態分開。" ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "id_source": "only actual ID/path from creation/status", "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." }, "method": { "http": "POST", "path": "/v1/videos/generations" }, "operation_modes": [ "videos" ], "output": { "family": [ "video" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"model\": \"google/omni-1.1-flash\", \"prompt\": \"A person walks slowly through a quiet garden as the camera tracks from the side.\"}'", "label": "Create video · retained exact shape", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\"", "label": "GET status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id/content\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n --output video.mp4", "label": "GET content", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "影片", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "video" ], "path": "/v1/videos/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.03, "amount_unit": "usd_per_display_unit", "key": "video_output_360p_second", "label": "per second at 360p", "side": "out" } ] } ], "request_model_id": "google/omni-1.1-flash", "route_label": "Core", "status_reads": [ "GET /v1/videos/generations/{id}", "GET /v1/videos/generations/{id}/content" ], "tiers": [], "tool_prices": null, "unit": "video_output_360p_second", "units": [ { "key": "video_output_360p_second", "label": "per second at 360p", "side": "out", "usd": 0.03 } ] } }, { "html": "
G

Omni 1.1 Flash

Google /omni-featured

入門

文字轉影片，可選 4／6／8／10 秒、360p／720p，必選直式或橫式。

接受的輸入
文字
結果
影片
關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。

google/omni-1.1-flash 可選 4、6、8、10 秒，必填 360p 或 720p，以及 aspect_ratio 的 VIDEO_ASPECT_RATIO_LANDSCAPE 或 VIDEO_ASPECT_RATIO_PORTRAIT。可做短直式商品預告，在 prompt 指定主體及可見動作。

提交 /v1/videos/generations，收集原工作結果。n、count 限一個輸出請求，未列圖片參考。因此是有界短片流程，不是任意長度編輯器。Flash 不保證延遲，完成收集時應保留實際回傳的每個輸出。

Ailoot 可用 · 輸入與方法

Ailoot · 影片 POST /v1/videos/generations
輸入
text
輸出
video
輸出格式
mp4
欄位類型要求值與限制預設值
欄位model類型string要求必填值與限制
omni-featured
預設值—
欄位prompt類型string要求必填值與限制
長度下限: 1
預設值—
欄位duration類型integer要求替代選項之一必填值與限制
4, 6, 8, 10
替代選項: duration_s；若同時提供兩個欄位，其值必須一致
符合以下條件時必填: 未提供 duration_s
至少一項必填: duration, duration_s
單位: 秒
預設值—
欄位duration_s類型integer要求選填值與限制
4, 6, 8, 10
替代選項: duration
單位: 秒
預設值—
欄位resolution類型string要求必填值與限制
360p, 720p
預設值—
欄位aspect_ratio類型string要求必填值與限制
VIDEO_ASPECT_RATIO_LANDSCAPE, VIDEO_ASPECT_RATIO_PORTRAIT
預設值—
欄位n類型integer要求選填值與限制
1
預設值1
欄位count類型integer要求選填值與限制
1
適用條件: 若也提供 n，值必須一致
預設值—
輸入素材組合

文字生成影片 · 必填： prompt

方法參數與生命週期
參數規格
參數material_types規格text
參數required規格null
參數optional_controls規格null

生命週期： 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 均為精確值；供應商能力與准入狀態分開。

方案

Ailoot 方法費率

Ailoot 影片POST /v1/videos/generations
輸出
US$0.03 360p 每秒

Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

請求範例

Ailoot · 影片

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"model": "omni-featured", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

接收並儲存結果

Ailoot · 影片

mp4

查看工作狀態
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY"
其他內容讀取方式
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1\ncurl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" \\\n  --output video.mp4
保留所有已完成的結果

請儲存每部已完成的影片或傳回的檔案，並從實際傳回的每個素材 URL 取得素材。

data[] 包含所有回傳的內容路徑；content_url 僅代表第一個輸出

需要檢查原始回應時

請讀取現有的原始作業；切勿重新提交傳送結果不明的請求。

錯誤與後續步驟
回應條件下一步
回應400 · invalid_request_error條件必要的 prompt/resolution/aspect/duration 缺漏或無效下一步提交新的請求前，請先修正無效的請求欄位。
回應409 · video_not_ready條件原始影片內容尚無法取得下一步請輪詢原始回傳的 ID，並遵守 Retry-After。
回應503 · server_error條件結果需要查核下一步請保留原始 ID 與請求紀錄憑證；切勿重新建立此操作。
回應server_error條件回傳的回應表示該作業或結果需要檢查下一步保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。

別名

模型別名

Ailoot google/omni-1.1-flash, omni-featured

方法路徑別名

請使用上方列出的 API 方法路徑。

相關呼叫用 ID

google/omni-1.1-flash, omni-featured

", "method_identity": { "effective_request_model_id": "omni-featured", "fmt": "videos", "http": "POST", "path": "/v1/videos/generations", "request_model_id": "omni-featured", "route_label": "Core" }, "method_key": "Core|videos|/v1/videos/generations|omni-featured", "ordinal": 1, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "data[] 包含所有回傳的內容路徑；content_url 僅代表第一個輸出", "errors": [ { "condition": "必要的 prompt/resolution/aspect/duration 缺漏或無效", "http_status": 400, "recovery": "提交新的請求前，請先修正無效的請求欄位。", "type": "invalid_request_error" }, { "condition": "原始影片內容尚無法取得", "http_status": 409, "recovery": "請輪詢原始回傳的 ID，並遵守 Retry-After。", "type": "video_not_ready" }, { "condition": "結果需要查核", "http_status": 503, "recovery": "請保留原始 ID 與請求紀錄憑證；切勿重新建立此操作。", "type": "server_error" }, { "code": null, "condition": "回傳的回應表示該作業或結果需要檢查", "http_status": null, "recovery": "保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos/generations" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "operation_id_is_not_task_id": true, "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": [ { "mode": "text_to_video", "optional": [], "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": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_outputs": "data[] contains all returned content paths; content_url is first only", "content_selection": "The Core content handler serves the primary video. Fetch every actual status.data[] path for all outputs; no indexed content query is implemented by this handler.", "create_fields": [ "id", "object", "model", "status", "duration_s", "resolution" ], "create_status": 202, "family": "video", "format": "mp4", "pending_status": "in_progress", "retry_after_pending_seconds": 10, "status_enum": [ "in_progress", "completed" ], "status_fields": [ "id", "object", "model", "status", "duration_s", "resolution", "content_url", "data", "partial", "content_revoked", "result_pending_check" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "omni-featured" ], "enum_known": true, "enum_status": "specified", "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": null, "enum_known": false, "enum_status": "not_specified", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "alternative": "duration_s；若同時提供兩個欄位，其值必須一致", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration", "required": false, "required_any_of": [ "duration", "duration_s" ], "required_when": "未提供 duration_s", "type": "integer", "unit": "秒" }, { "alternative": "duration", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration_s", "required": false, "type": "integer", "unit": "秒" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "360p", "720p" ], "enum_known": true, "enum_status": "specified", "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "VIDEO_ASPECT_RATIO_LANDSCAPE", "VIDEO_ASPECT_RATIO_PORTRAIT" ], "enum_known": true, "enum_status": "specified", "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "default_status": "specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "count", "required": false, "type": "integer", "when": "若也提供 n，值必須一致" } ], "required_parameter_combinations": [ [ "model", "prompt", "duration", "resolution", "aspect_ratio" ], [ "model", "prompt", "duration_s", "resolution", "aspect_ratio" ] ], "unsupported": [] }, "hints": [ "方法結構與 ID 均為精確值；供應商能力與准入狀態分開。" ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "id_source": "only actual ID/path from creation/status", "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." }, "method": { "http": "POST", "path": "/v1/videos/generations" }, "operation_modes": [ "videos" ], "output": { "family": [ "video" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"model\": \"omni-featured\", \"prompt\": \"A person walks slowly through a quiet garden as the camera tracks from the side.\"}'", "label": "Create video · retained exact shape", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\"", "label": "GET status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id/content\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n --output video.mp4", "label": "GET content", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "影片", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "video" ], "path": "/v1/videos/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.03, "amount_unit": "usd_per_display_unit", "key": "video_output_360p_second", "label": "per second at 360p", "side": "out" } ] } ], "request_model_id": "omni-featured", "route_label": "Core", "status_reads": [ "GET /v1/videos/generations/{id}", "GET /v1/videos/generations/{id}/content" ], "tiers": [], "tool_prices": null, "unit": "video_output_360p_second", "units": [ { "key": "video_output_360p_second", "label": "per second at 360p", "side": "out", "usd": 0.03 } ] } } ], "model_id": "google/omni-1.1-flash", "nativeProvenance": { "input_facts_canonical_sha256": "53f6f66d407c8577a2693b7d517ad9a6eb5d784a0fc6a1eeeb883452c4813d96", "input_html_sha256": "805927441b59d228a97d2de5a100234ea354ee17d5231d3e8b291e5a484eebc6", "private_audit_sha256": "cd2448bb85937873e6a0180f17ff4e625a07fde81be9ca74eda916fb2ee20e54", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/zh-hant-tw/google-omni-1-1-flash/", "description": "文字轉影片，可選 4／6／8／10 秒、360p／720p，必選直式或橫式。", "locale": "zh-hant-tw", "md_url": "https://ailoot.ai/models/zh-hant-tw/google-omni-1-1-flash/index.md", "title": "Omni 1.1 Flash — Ailoot", "url": "https://ailoot.ai/models/zh-hant-tw/google-omni-1-1-flash/" }, "rawModel": { "about": "此處介紹的 Omni 1.1 Flash 是具名影片生成規格，接受文字輸入並輸出影片。\n\n請圍繞一個容易理解的場景建立提示詞。描述主體、動作、發生地點，以及攝影機如何取景。產品簡述可指定材質、光線與動態；敘事簡述則可定義角色動作及場景變化。\n\n依序列出視覺優先事項。加入氣氛、裝飾細節或運鏡之前，先讓主要動作清楚。", "alias_of": null, "aliases": [ "omni-featured" ], "author": "Google", "ctx": null, "formats": [ "videos" ], "id": "google/omni-1.1-flash", "input": [ "text" ], "kind": "video", "max_out": null, "methods": [ { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "data[] 包含所有回傳的內容路徑；content_url 僅代表第一個輸出", "errors": [ { "condition": "必要的 prompt/resolution/aspect/duration 缺漏或無效", "http_status": 400, "recovery": "提交新的請求前，請先修正無效的請求欄位。", "type": "invalid_request_error" }, { "condition": "原始影片內容尚無法取得", "http_status": 409, "recovery": "請輪詢原始回傳的 ID，並遵守 Retry-After。", "type": "video_not_ready" }, { "condition": "結果需要查核", "http_status": 503, "recovery": "請保留原始 ID 與請求紀錄憑證；切勿重新建立此操作。", "type": "server_error" }, { "code": null, "condition": "回傳的回應表示該作業或結果需要檢查", "http_status": null, "recovery": "保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos/generations" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "operation_id_is_not_task_id": true, "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": [ { "mode": "text_to_video", "optional": [], "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": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_outputs": "data[] contains all returned content paths; content_url is first only", "content_selection": "The Core content handler serves the primary video. Fetch every actual status.data[] path for all outputs; no indexed content query is implemented by this handler.", "create_fields": [ "id", "object", "model", "status", "duration_s", "resolution" ], "create_status": 202, "family": "video", "format": "mp4", "pending_status": "in_progress", "retry_after_pending_seconds": 10, "status_enum": [ "in_progress", "completed" ], "status_fields": [ "id", "object", "model", "status", "duration_s", "resolution", "content_url", "data", "partial", "content_revoked", "result_pending_check" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "google/omni-1.1-flash" ], "enum_known": true, "enum_status": "specified", "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": null, "enum_known": false, "enum_status": "not_specified", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "alternative": "duration_s；若同時提供兩個欄位，其值必須一致", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration", "required": false, "required_any_of": [ "duration", "duration_s" ], "required_when": "未提供 duration_s", "type": "integer", "unit": "秒" }, { "alternative": "duration", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration_s", "required": false, "type": "integer", "unit": "秒" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "360p", "720p" ], "enum_known": true, "enum_status": "specified", "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "VIDEO_ASPECT_RATIO_LANDSCAPE", "VIDEO_ASPECT_RATIO_PORTRAIT" ], "enum_known": true, "enum_status": "specified", "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "default_status": "specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "count", "required": false, "type": "integer", "when": "若也提供 n，值必須一致" } ], "required_parameter_combinations": [ [ "model", "prompt", "duration", "resolution", "aspect_ratio" ], [ "model", "prompt", "duration_s", "resolution", "aspect_ratio" ] ], "unsupported": [] }, "hints": [ "方法結構與 ID 均為精確值；供應商能力與准入狀態分開。" ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "id_source": "only actual ID/path from creation/status", "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." }, "method": { "http": "POST", "path": "/v1/videos/generations" }, "operation_modes": [ "videos" ], "output": { "family": [ "video" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"model\": \"google/omni-1.1-flash\", \"prompt\": \"A person walks slowly through a quiet garden as the camera tracks from the side.\"}'", "label": "Create video · retained exact shape", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\"", "label": "GET status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id/content\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n --output video.mp4", "label": "GET content", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "影片", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "video" ], "path": "/v1/videos/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.03, "amount_unit": "usd_per_display_unit", "key": "video_output_360p_second", "label": "per second at 360p", "side": "out" } ] } ], "request_model_id": "google/omni-1.1-flash", "route_label": "Core", "status_reads": [ "GET /v1/videos/generations/{id}", "GET /v1/videos/generations/{id}/content" ], "tiers": [], "tool_prices": null, "unit": "video_output_360p_second", "units": [ { "key": "video_output_360p_second", "label": "per second at 360p", "side": "out", "usd": 0.03 } ] }, { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "data[] 包含所有回傳的內容路徑；content_url 僅代表第一個輸出", "errors": [ { "condition": "必要的 prompt/resolution/aspect/duration 缺漏或無效", "http_status": 400, "recovery": "提交新的請求前，請先修正無效的請求欄位。", "type": "invalid_request_error" }, { "condition": "原始影片內容尚無法取得", "http_status": 409, "recovery": "請輪詢原始回傳的 ID，並遵守 Retry-After。", "type": "video_not_ready" }, { "condition": "結果需要查核", "http_status": 503, "recovery": "請保留原始 ID 與請求紀錄憑證；切勿重新建立此操作。", "type": "server_error" }, { "code": null, "condition": "回傳的回應表示該作業或結果需要檢查", "http_status": null, "recovery": "保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content" }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "create": { "http": "POST", "path": "/v1/videos/generations" }, "id_source": "Actualreturnedpublicid; opaque URLencodeit forGET", "mode": "submit_once_poll_original", "multioutputs": "retain every completed data output; index0 alone is not all outputs", "operation_id_is_not_task_id": true, "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": [ { "mode": "text_to_video", "optional": [], "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": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_video" ], "outputs": { "all_outputs": "data[] contains all returned content paths; content_url is first only", "content_selection": "The Core content handler serves the primary video. Fetch every actual status.data[] path for all outputs; no indexed content query is implemented by this handler.", "create_fields": [ "id", "object", "model", "status", "duration_s", "resolution" ], "create_status": 202, "family": "video", "format": "mp4", "pending_status": "in_progress", "retry_after_pending_seconds": 10, "status_enum": [ "in_progress", "completed" ], "status_fields": [ "id", "object", "model", "status", "duration_s", "resolution", "content_url", "data", "partial", "content_revoked", "result_pending_check" ] }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "omni-featured" ], "enum_known": true, "enum_status": "specified", "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": null, "enum_known": false, "enum_status": "not_specified", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "alternative": "duration_s；若同時提供兩個欄位，其值必須一致", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration", "required": false, "required_any_of": [ "duration", "duration_s" ], "required_when": "未提供 duration_s", "type": "integer", "unit": "秒" }, { "alternative": "duration", "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 4, 6, 8, 10 ], "enum_known": true, "enum_status": "specified", "name": "duration_s", "required": false, "type": "integer", "unit": "秒" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "360p", "720p" ], "enum_known": true, "enum_status": "specified", "name": "resolution", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ "VIDEO_ASPECT_RATIO_LANDSCAPE", "VIDEO_ASPECT_RATIO_PORTRAIT" ], "enum_known": true, "enum_status": "specified", "name": "aspect_ratio", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "default_status": "specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "default_status": "not_specified", "enum": [ 1 ], "enum_known": true, "enum_status": "specified", "name": "count", "required": false, "type": "integer", "when": "若也提供 n，值必須一致" } ], "required_parameter_combinations": [ [ "model", "prompt", "duration", "resolution", "aspect_ratio" ], [ "model", "prompt", "duration_s", "resolution", "aspect_ratio" ] ], "unsupported": [] }, "hints": [ "方法結構與 ID 均為精確值；供應商能力與准入狀態分開。" ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "content": [ { "http": "GET", "path": "/v1/videos/{request_id}/content", "query": { "index": "actual output index; default0" } }, { "http": "GET", "path": "/v1/videos/generations/{request_id}/content" } ], "id_source": "only actual ID/path from creation/status", "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." }, "method": { "http": "POST", "path": "/v1/videos/generations" }, "operation_modes": [ "videos" ], "output": { "family": [ "video" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\ncurl https://api.ailoot.ai/v1/videos/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"model\": \"omni-featured\", \"prompt\": \"A person walks slowly through a quiet garden as the camera tracks from the side.\"}'", "label": "Create video · retained exact shape", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\"", "label": "GET status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\n: \"${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}\"\nexport AILOOT_VIDEO_ID\nvideo_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ[\"AILOOT_VIDEO_ID\"], safe=\"\"))') || exit 1\ncurl \"https://api.ailoot.ai/v1/videos/generations/$video_id/content\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" \\\n --output video.mp4", "label": "GET content", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "影片", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "video" ], "path": "/v1/videos/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.03, "amount_unit": "usd_per_display_unit", "key": "video_output_360p_second", "label": "per second at 360p", "side": "out" } ] } ], "request_model_id": "omni-featured", "route_label": "Core", "status_reads": [ "GET /v1/videos/generations/{id}", "GET /v1/videos/generations/{id}/content" ], "tiers": [], "tool_prices": null, "unit": "video_output_360p_second", "units": [ { "key": "video_output_360p_second", "label": "per second at 360p", "side": "out", "usd": 0.03 } ] } ], "model_aliases": [ { "canonical_model_id": "google/omni-1.1-flash", "request_model_id": "google/omni-1.1-flash", "route_label": "Core" }, { "canonical_model_id": "google/omni-1.1-flash", "request_model_id": "omni-featured", "route_label": "Core" } ], "name": "Omni 1.1 Flash", "price": { "in": null, "in_label": null, "out": 0.03, "out_label": "per second at 360p", "sort_in": null, "sort_out": null, "varies": false }, "short": "Omni 1.1 Flash 是具名的文字轉影片設定檔。請描述可見主體、動作、場景與鏡頭運動，為生成場景準備清楚的製作簡報。" }, "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 }, { "contract_json_pointer": "/methods/1/rawMethod/contract", "html_json_pointer": "/methods/1/html", "method_ordinal": 1 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod", "/methods/1/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "文字轉影片，可選 4／6／8／10 秒、360p／720p，必選直式或橫式。", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "14c01f2776f9a1353ff9313a252acda22a0bca950fa068937cca8572e9a720ac", "renderer_sha256": "13a3fc1b22d07359278e2249d630bfc9bb9e6416c71ba53def933fb5a903660b" }, "sourceRevision": "13aad28689f1d4f64f62590b53e9420a98dedc4b08d9499cc3018448c6b6f681" }