素材をダウンロード
download_assetの引数、結果スキーマ、OAuth権限、安全注釈を確認済みMCP契約から生成した参考資料です。
このページの目次
ツール
download_asset
所有する成果物の情報と短期限の署名付きダウンロードURLを返します。
権限と安全
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 |
Owned asset ID from task outputs, not a task ID. |
引数の例
{
"asset_id": "00000000-0000-4000-8000-000000000003"
}
構造化された結果
| フィールド | 型 | 必須 | 既定値 | 制約 | 説明 |
|---|---|---|---|---|---|
byte_size |
integer |
はい | — | — | Expected file size in bytes. |
created_at |
string |
はい | — | format: date-time |
Creation timestamp in UTC. |
download_expires_at |
string |
はい | — | format: date-time |
Signed URL expiry in UTC; refresh via asset lookup when expired. |
download_url |
string |
はい | — | — | Sensitive short-lived signed URL. Download without a Bearer header, including after redirects; never log the URL. |
format |
string |
はい | — | — | Artifact format; inspect actual outputs rather than assuming an array order. |
id |
string |
はい | — | format: uuid |
Stable public asset ID; use it to refresh download metadata. |
media |
MediaResponse / null |
いいえ | null |
— | Whitelisted measured video metadata. Unknown fields are null; non-video assets return null. |
mime_type |
string |
はい | — | — | Asset media type. |
object |
string |
いいえ | "asset" |
const: "asset" |
— |
エラーと次の対応
ツールエラーのerrorにはcode、message、retryable、request_id、detailsがあります。メッセージ本文に依存した分岐や私的入力の漏えいを避けてください。終状態の失敗でも部分成果物を調べます。署名付きURLは保存済みファイルではありません。
この記事は役に立ちましたか？
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー