跳至本文
使用文件

搜尋文件

搜尋僅在此瀏覽器進行,關鍵字不會傳送或儲存。請勿輸入憑證。

正在載入搜尋索引…

Tab 或方向鍵移動 · Enter 開啟 · Esc 關閉
瀏覽文件

準備影片上傳

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

公開測試最後核實
本頁目錄

工具

prepare_video_upload

建立私有影片上傳會話,限制 100 MiB、30 秒;傳輸後完成校驗,不啟動深度處理。

權限與安全

OAuth 權限:files:write

訊號 值
destructiveHint false
idempotentHint false
openWorldHint true
readOnlyHint false
spendsCredits false
requiresUserConfirmation false
sideEffects temporary_upload_created

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

輸入引數

欄位 型別 必填 預設值 約束 含義
request VideoUploadRequest 是 — — —

引數示例

json
{
  "request": {
    "byte_size": 1024,
    "filename": "motion.mp4",
    "mime_type": "video/mp4"
  }
}

結構化返回

欄位 型別 必填 預設值 約束 含義
expires_at string 是 — format: date-time 上傳會話到期的 UTC 時間。
headers object 是 — — 傳輸位元組使用這些請求頭。
max_bytes integer 是 — — 來源位元組數上限。
method string 否 "PUT" const: "PUT" —
upload_id string 是 — format: uuid 傳輸位元組後需完成的會話,目前還不能作為影片輸入。
upload_url string 是 — — 敏感短期上傳 URL;傳輸位元組時不附加 API/OAuth 憑據。

VideoUploadSession

錯誤與後續步驟

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

標準工作流 · 支出保護

這篇文件有幫助嗎?

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

需要協助?聯絡支援