獲取資產下載資訊
從真實 download_asset 工具生成輸入、輸出、OAuth 權限與安全註解，與經過核實的 MCP 契約保持一致。
本頁目錄
工具
download_asset
返回所屬資產資訊和短期簽名 URL，不自動儲存本地檔案；下載不攜帶 API 或 OAuth 憑據。
權限與安全
OAuth 權限：assets:read
| 訊號 | 值 |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
true |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | signed_url_issued |
註解用於描述安全屬性，不能替代使用者批准、OAuth 授權或服務端校驗。
輸入引數
| 欄位 | 型別 | 必填 | 預設值 | 約束 | 含義 |
|---|---|---|---|---|---|
asset_id |
string |
是 | — | format: uuid |
任務 outputs 中的所屬資產 ID，不是任務 ID。 |
引數示例
{
"asset_id": "00000000-0000-4000-8000-000000000003"
}
結構化返回
| 欄位 | 型別 | 必填 | 預設值 | 約束 | 含義 |
|---|---|---|---|---|---|
byte_size |
integer |
是 | — | — | 檔案預期位元組數。 |
created_at |
string |
是 | — | format: date-time |
UTC 建立時間。 |
download_expires_at |
string |
是 | — | format: date-time |
簽名 URL 的 UTC 過期時間；過期後重新查詢資產。 |
download_url |
string |
是 | — | — | 敏感短期簽名 URL；下載及跳轉時均不攜帶 Bearer 頭，不記錄此 URL。 |
format |
string |
是 | — | — | 實際資產格式，不要依賴 outputs 固定順序。 |
id |
string |
是 | — | format: uuid |
穩定公共資產 ID，用於重新整理下載資訊。 |
media |
MediaResponse / null |
否 | null |
— | 白名單內的實測影片資訊，未知欄位為 null；非影片資產為 null。 |
mime_type |
string |
是 | — | — | 資產媒體型別。 |
object |
string |
否 | "asset" |
const: "asset" |
— |
錯誤與後續步驟
工具錯誤包含 error 物件，內有 code、message、retryable、request_id 和 details。不要依賴訊息文本分支或洩露私有輸入。終態失敗也要檢查部分產物；返回簽名 URL 不代表已儲存檔案。
這篇文件有幫助嗎？
不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策