Ana sayfa → Yardım

Görsel girdi bir vision modeli tarafından reddediliyor

Ya base64 yükünün data URL ön eki eksiktir, ya kodlama satır sonları içerir, ya dosya boyut sınırını aşar ya da format modelin kabul etmediği bir formattır. Hata metni bunları nadiren ayırt eder.

Gördüğünüz hata

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

Neden oluyor

image_url olarak gönderilen bir base64 görseli, medya türü dahil tam data URL'ye ihtiyaç duyar: data:image/png;base64,. Yükü çıplak göndermek en yaygın tek sebeptir.

Komut satırındaki base64, birçok sistemde varsayılan olarak satırları böler. Gömülü satır sonları, doğru görünse bile yükü geçersiz kılar. Bölmeyi kapatan seçeneği kullanın.

Boyut sınırları, diskteki dosyadan yaklaşık üçte bir daha büyük olan kodlanmış yüke uygulanır. Yerelde sınırın hemen altındaki bir görsel, ağ üzerinde sınırı aşabilir.

Sebebin bu olduğunu doğrulayın

Satır bölmeden kodlayın ve ön ekin var olduğunu doğrulayın:

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

İlk 40 karakter data:image/png;base64, ile başlamalıdır. Yükünüzün bayt sayısı beklenenden çok büyükse dosyanın kendisi fazla büyüktür.

Nasıl düzeltilir

Tam data URL'yi gönderinŞemayı ve medya türünü ekleyin. image/jpeg medya türüyle gönderilen bir PNG de bazı modellerce reddedilir, bu yüzden gerçek formatla eşleştirin.
Kodlarken satır bölmeyi kapatınLinux'ta base64 -w0, macOS'ta ise satır sonlarını silmek için çıktıyı tr -d'den geçirin.
Göndermeden önce yeniden boyutlandırınÇoğu vision modeli zaten içeride küçültür. 12 megapiksellik bir fotoğraf göndermek, cevabı iyileştirmeden yükleme süresine ve token'a mal olur.

APICLAN'da görsel girdi, girdi token'ı olarak ücretlendirilir ve büyük görseller daha fazla token'a dönüştüğü için daha pahalıdır. Çağrıdan önce yeniden boyutlandırmak yalnızca sınırı aşmanın yolu değil, doğrudan bir tasarruftur.

İlgili konular

OpenAI uyumlu bir API'yi çağırırken Unexpected token '<' hatası 401 invalid API key – anahtar doğru göründüğü halde hata veriyorsa

Son kontrol: 2026-10-01. Canlı bir OpenAI uyumlu ağ geçidinde teşhis edilen sorunlardan yazılmıştır, başka sitelerden derlenmemiştir.