获取资产下载信息
从真实 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，用于刷新下载信息。 |
mime_type |
string |
是 | — | — | 资产媒体类型。 |
object |
string |
否 | "asset" |
const: "asset" |
— |
错误与后续步骤
工具错误包含 error 对象，内有 code、message、retryable、request_id 和 details。不要依赖消息文本分支或泄露私有输入。终态失败也要检查部分产物；返回签名 URL 不代表已保存文件。
这篇文档有帮助吗？
不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。 隐私政策