完成圖片上傳
從真實 complete_image_upload 工具生成輸入、輸出、OAuth 權限與安全註解，與經過核實的 MCP 契約保持一致。
本頁目錄
工具
complete_image_upload
校驗已傳輸的圖片並返回可複用 file_id；此 ID 用於生成輸入。
權限與安全
OAuth 權限：files:write
| 訊號 | 值 |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | uploaded_image_persisted |
註解用於描述安全屬性，不能替代使用者批准、OAuth 授權或服務端校驗。
輸入引數
| 欄位 | 型別 | 必填 | 預設值 | 約束 | 含義 |
|---|---|---|---|---|---|
upload_id |
string |
是 | — | format: uuid |
實際位元組傳輸完成後，傳入 prepare_image_upload 返回的會話 ID。 |
引數示例
{
"upload_id": "00000000-0000-4000-8000-000000000007"
}
結構化返回
| 欄位 | 型別 | 必填 | 預設值 | 約束 | 含義 |
|---|---|---|---|---|---|
byte_size |
integer |
是 | — | — | 校驗後的圖片位元組數。 |
file_id |
string |
是 | — | format: uuid |
用於 request.input.first_frame 的可複用所屬公共檔案 ID。 |
mime_type |
string |
是 | — | — | 校驗後的圖片 MIME 型別。 |
sha256 |
string |
是 | — | — | 上傳圖片位元組的 SHA-256。 |
錯誤與後續步驟
工具錯誤包含 error 物件，內有 code、message、retryable、request_id 和 details。不要依賴訊息文本分支或洩露私有輸入。終態失敗也要檢查部分產物；返回簽名 URL 不代表已儲存檔案。
這篇文件有幫助嗎？
不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策