Bild-Upload vorbereiten
Generierte Referenz für prepare_image_upload: Argumente, Ergebnisschema, OAuth-Berechtigungen und Sicherheitsannotation aus dem geprüften MCP-Vertrag.
Auf dieser Seite
Tool
prepare_image_upload
Bereitet einen kurzlebigen direkten Upload vor. Übertrage exakt byte_size Bytes per PUT mit der zurückgegebenen URL und den Headern und rufe anschließend complete_image_upload auf.
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 |
|---|---|---|---|---|---|
byte_size |
integer |
Ja | — | exclusiveMinimum: 0 |
Exact number of bytes the client will PUT. |
filename |
string |
Ja | — | minLength: 1; maxLength: 240 |
Client filename, not a local path the server can read. |
mime_type |
string |
Ja | — | pattern: ^image/(png|jpeg|webp)$ |
Actual image MIME type. |
Beispielargumente
{
"byte_size": 1024,
"filename": "character.png",
"mime_type": "image/png"
}
Strukturiertes Ergebnis
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
expires_at |
string |
Ja | — | format: date-time |
Upload URL expiry. |
headers |
object |
Ja | — | — | Exact transfer headers; do not add MCP tokens or API Bearer credentials. |
max_bytes |
integer |
Ja | — | — | Maximum accepted upload byte count. |
method |
string |
Nein | "PUT" |
const: "PUT" |
HTTP method the client must use for the byte transfer. |
upload_id |
string |
Ja | — | format: uuid |
Upload session ID for complete_image_upload, not the final file_id. |
upload_url |
string |
Ja | — | — | Sensitive short-lived upload URL. Transfer actual bytes; do not publish this URL. |
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