準備影片上傳
從真實 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 | 是 | — | — | — |
引數示例
{
"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 憑據。 |
錯誤與後續步驟
工具錯誤包含 error 物件,內有 code、message、retryable、request_id 和 details。不要依賴訊息文本分支或洩露私有輸入。終態失敗也要檢查部分產物;返回簽名 URL 不代表已儲存檔案。
這篇文件有幫助嗎?
不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策