Start → Hilfe

Bild-Input wird von einem Vision-Modell abgelehnt

Was Sie sehen

• invalid_request_error: Could not process image
• Invalid base64 image_url
• image exceeds N MB maximum
• The same image works in the web UI and fails through the API

Warum das passiert

Ein base64-Bild, das als image_url gesendet wird, braucht die vollständige Data-URL einschließlich Medientyp: data:image/png;base64,. Die nackte Nutzlast zu senden ist die mit Abstand häufigste Ursache.

Das Kommandozeilen-base64 bricht auf vielen Systemen standardmäßig Zeilen um. Die eingebetteten Zeilenumbrüche machen die Nutzlast ungültig, obwohl sie richtig aussieht. Verwenden Sie die Option, die den Umbruch abschaltet.

Größenlimits gelten für die kodierte Nutzlast, die etwa ein Drittel größer ist als die Datei auf der Festplatte. Ein Bild, das lokal knapp unter dem Limit liegt, kann auf der Leitung darüber sein.

Prüfen, ob es daran liegt

Kodieren Sie ohne Zeilenumbruch und prüfen Sie, dass das Präfix vorhanden ist:

b64=$(base64 -w0 image.png)      # macOS: base64 -i image.png | tr -d '\n'
echo "payload bytes: ${#b64}"
printf 'data:image/png;base64,%s' "$b64" | head -c 40; echo

Die ersten 40 Zeichen sollten mit data:image/png;base64, beginnen. Sind die Bytes Ihrer Nutzlast viel größer als erwartet, ist die Datei selbst zu groß.

So beheben Sie es

1. Die vollständige Data-URL sendenSchema und Medientyp gehören dazu. Ein PNG mit dem Medientyp image/jpeg wird von manchen Modellen ebenfalls abgelehnt, also passen Sie ihn an das echte Format an.
2. Zeilenumbruch beim Kodieren abschaltenbase64 -w0 unter Linux, oder unter macOS durch tr -d leiten, um Zeilenumbrüche zu entfernen.
3. Vor dem Senden verkleinernDie meisten Vision-Modelle skalieren intern ohnehin herunter. Ein 12-Megapixel-Foto zu senden kostet Upload-Zeit und Tokens, ohne die Antwort zu verbessern.

Verwandte Themen

Zuletzt geprüft am 2026-10-01. Geschrieben aus Problemen, die auf einem laufenden OpenAI-kompatiblen Gateway diagnostiziert wurden – nicht von anderen Seiten zusammengetragen.