Asset herunterladen
Generierte Referenz für download_asset: Argumente, Ergebnisschema, OAuth-Berechtigungen und Sicherheitsannotation aus dem geprüften MCP-Vertrag.
Auf dieser Seite
Tool
download_asset
Liefert Metadaten eines eigenen Assets und eine kurzlebige signierte Download-URL.
Berechtigungen und Sicherheit
OAuth-Berechtigung: assets:read
| Signal | Wert |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
true |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | signed_url_issued |
Annotationen beschreiben Sicherheitseigenschaften. Sie ersetzen weder Zustimmung noch OAuth-Autorisierung oder serverseitige Prüfungen.
Eingabeargumente
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
asset_id |
string |
Ja | — | format: uuid |
Owned asset ID from task outputs, not a task ID. |
Beispielargumente
{
"asset_id": "00000000-0000-4000-8000-000000000003"
}
Strukturiertes Ergebnis
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
byte_size |
integer |
Ja | — | — | Expected file size in bytes. |
created_at |
string |
Ja | — | format: date-time |
Creation timestamp in UTC. |
download_expires_at |
string |
Ja | — | format: date-time |
Signed URL expiry in UTC; refresh via asset lookup when expired. |
download_url |
string |
Ja | — | — | Sensitive short-lived signed URL. Download without a Bearer header, including after redirects; never log the URL. |
format |
string |
Ja | — | — | Artifact format; inspect actual outputs rather than assuming an array order. |
id |
string |
Ja | — | format: uuid |
Stable public asset ID; use it to refresh download metadata. |
media |
MediaResponse / null |
Nein | null |
— | Whitelisted measured video metadata. Unknown fields are null; non-video assets return null. |
mime_type |
string |
Ja | — | — | Asset media type. |
object |
string |
Nein | "asset" |
const: "asset" |
— |
Fehler und nächste Schritte
Tool-Fehler enthalten ein error-Objekt mit code, message, retryable, request_id und details. Steuere den Ablauf nicht anhand des Meldungstexts und lege keine privaten Eingaben offen. Prüfe nach endgültigen Fehlern auch Teilergebnisse; eine signierte URL ist noch keine gespeicherte Datei.
War diese Seite hilfreich?
Es werden keine Suchbegriffe, Codes oder Freitexte erfasst. Dieser Schalter steuert nur Dokumentationsinteraktionen; allgemeine Website-Analysen folgen der Datenschutzerklärung. Datenschutzerklärung