Video-Upload vorbereiten
Generierte Referenz für prepare_video_upload: Argumente, Ergebnisschema, OAuth-Berechtigungen und Sicherheitsannotation aus dem geprüften MCP-Vertrag.
Auf dieser Seite
Tool
prepare_video_upload
Erstellt einen privaten Upload für MP4/MOV/WebM bis 100 MiB und 30 Sekunden. Übertrage die Bytes und schließe den Upload ab; keine Tiefenberechnung oder Generierung.
Berechtigungen und Sicherheit
OAuth-Berechtigung: files:write
| Signal | Wert |
|---|---|
destructiveHint |
false |
idempotentHint |
false |
openWorldHint |
true |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | temporary_upload_created |
Annotationen beschreiben Sicherheitseigenschaften. Sie ersetzen weder Zustimmung noch OAuth-Autorisierung oder serverseitige Prüfungen.
Eingabeargumente
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
request |
VideoUploadRequest | Ja | — | — | — |
Beispielargumente
{
"request": {
"byte_size": 1024,
"filename": "motion.mp4",
"mime_type": "video/mp4"
}
}
Strukturiertes Ergebnis
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
expires_at |
string |
Ja | — | format: date-time |
Upload session expiry in UTC. |
headers |
object |
Ja | — | — | Use these exact headers for byte transfer. |
max_bytes |
integer |
Ja | — | — | Source byte limit. |
method |
string |
Nein | "PUT" |
const: "PUT" |
— |
upload_id |
string |
Ja | — | format: uuid |
Session to complete after transferring bytes; not usable as a video input yet. |
upload_url |
string |
Ja | — | — | Sensitive short-lived upload URL. Transfer bytes without API/OAuth credentials. |
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