Guida rapida Prezzi

Home → Assistenza

Immagine in input rifiutata da un modello di visione

O al contenuto base64 manca il prefisso data URL, o la codifica contiene degli a capo, o il file supera il limite di dimensione, o il formato non è accettato dal modello. Il testo dell'errore raramente li distingue.

Cosa vedi

Perché succede

Un'immagine base64 inviata come image_url ha bisogno della data URL completa, tipo di media incluso: data:image/png;base64,. Inviare solo il contenuto è di gran lunga la causa più comune.

Lo strumento base64 da riga di comando va a capo per impostazione predefinita su molti sistemi. Gli a capo inseriti rendono il contenuto non valido anche se sembra corretto. Usa l'opzione che disattiva l'andata a capo.

I limiti di dimensione si applicano al contenuto codificato, che è circa un terzo più grande del file su disco. Un'immagine appena sotto il limite in locale può superarlo una volta trasmessa.

Verifica se la causa è questa

Codifica senza andare a capo e verifica che il prefisso sia presente:

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

I primi 40 caratteri devono iniziare con data:image/png;base64,. Se il contenuto occupa molti più byte del previsto, è il file stesso a essere troppo grande.

Come risolvere

  1. Invia la data URL completaIncludi lo schema e il tipo di media. Un PNG inviato con il tipo image/jpeg viene rifiutato anche da alcuni modelli, quindi fallo corrispondere al formato reale.
  2. Disattiva l'andata a capo durante la codificabase64 -w0 su Linux, oppure passa l'output attraverso tr -d per togliere gli a capo su macOS.
  3. Ridimensiona prima di inviareLa maggior parte dei modelli di visione riduce comunque l'immagine internamente. Inviare una foto da 12 megapixel ti costa tempo di caricamento e token senza migliorare la risposta.
Su APICLAN le immagini in input vengono addebitate come token di input, e le immagini più grandi costano di più perché diventano più token. Ridimensionare prima della chiamata è un risparmio diretto, non solo un modo per aggirare il limite.

Articoli correlati

Unexpected token '<' quando chiami un'API compatibile con OpenAI401 invalid API key: quando la chiave sembra giusta ma continua a fallire

Ultima verifica: 2026-10-01. Scritto a partire da problemi diagnosticati su un gateway compatibile con OpenAI in produzione, non raccolto da altri siti.