預覽源影片時間點

從真實 preview_video 工具生成輸入、輸出、OAuth 權限與安全註解，與經過核實的 MCP 契約保持一致。

公開測試最後核實 2026-09-15

本頁目錄

工具

preview_video

返回最多 12 格帶時間標籤的聯絡表與實際源時間；下載圖片後檢視。不呼叫 AI 或扣點數，計入儲存並受媒體預算限制。

權限與安全

OAuth 權限：assets:read

訊號	值
`destructiveHint`	`false`
`idempotentHint`	`true`
`openWorldHint`	`false`
`readOnlyHint`	`false`
spendsCredits	`false`
requiresUserConfirmation	`false`
sideEffects	`preview_asset_cached`, `signed_url_issued`

註解用於描述安全屬性，不能替代使用者批准、OAuth 授權或服務端校驗。

輸入引數

欄位	型別	必填	預設值	約束	含義
`asset_id`	`string`	是	—	`format`: `uuid`	—
`request`	VideoPreviewRequest	是	—	—	—

引數示例

json

{
  "asset_id": "00000000-0000-4000-8000-000000000003",
  "request": {
    "max_frame_size": 256,
    "timestamps_seconds": [
      0,
      1,
      2
    ]
  }
}

結構化返回

欄位	型別	必填	預設值	約束	含義
`cells`	array<PreviewCell>	是	—	—	按請求順序排列的縮圖，保留重複時間點。
`height`	`integer`	是	—	—	聯絡表高度，包含標籤及留白，單位畫素。
`image`	AssetResponse	是	—	—	快取的 PNG 聯絡表，提供可重新整理的簽名下載地址。
`object`	`string`	否	`"video_preview"`	const: `"video_preview"`	—
`source_video_asset_id`	`string`	是	—	`format`: `uuid`	穩定的源影片資產 ID。
`width`	`integer`	是	—	—	聯絡表寬度，包含標籤及留白，單位畫素。

VideoPreviewResponse

錯誤與後續步驟

工具錯誤包含 error 物件，內有 code、message、retryable、request_id 和 details。不要依賴訊息文本分支或洩露私有輸入。終態失敗也要檢查部分產物；返回簽名 URL 不代表已儲存檔案。

標準工作流 · 支出保護

這篇文件有幫助嗎？

允許文件互動分析

不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。隱私權政策

需要協助？聯絡支援