完成影片上傳
從真實 complete_video_upload 工具生成輸入、輸出、OAuth 權限與安全註解,與經過核實的 MCP 契約保持一致。
本頁目錄
工具
complete_video_upload
校驗影片並返回 file_id 及實測時長、尺寸,不啟動生成。
權限與安全
OAuth 權限:files:write
| 訊號 | 值 |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | uploaded_video_persisted |
註解用於描述安全屬性,不能替代使用者批准、OAuth 授權或服務端校驗。
輸入引數
| 欄位 | 型別 | 必填 | 預設值 | 約束 | 含義 |
|---|---|---|---|---|---|
upload_id |
string |
是 | — | format: uuid |
— |
引數示例
{
"upload_id": "00000000-0000-4000-8000-000000000008"
}
結構化返回
| 欄位 | 型別 | 必填 | 預設值 | 約束 | 含義 |
|---|---|---|---|---|---|
byte_size |
integer |
是 | — | — | 校驗後的來源位元組數。 |
duration_seconds |
number |
是 | — | — | 實測來源時長,選區必須在其範圍內。 |
file_id |
string |
是 | — | format: uuid |
用於 input.reference_video.source、type=file 的已完成影片檔案 ID。 |
height |
integer |
是 | — | — | 來源顯示高度,畫素。 |
mime_type |
string |
是 | — | — | 校驗後的影片型別。 |
object |
string |
否 | "file" |
const: "file" |
— |
sha256 |
string |
是 | — | — | 儲存來源位元組的 SHA-256。 |
width |
integer |
是 | — | — | 來源顯示寬度,畫素。 |
錯誤與後續步驟
工具錯誤包含 error 物件,內有 code、message、retryable、request_id 和 details。不要依賴訊息文本分支或洩露私有輸入。終態失敗也要檢查部分產物;返回簽名 URL 不代表已儲存檔案。
這篇文件有幫助嗎?
不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策