Inicio rápido Precios

Inicio → Ayuda

Imagen de entrada rechazada por un modelo de visión

O al contenido base64 le falta el prefijo data URL, o la codificación incluyó saltos de línea, o el archivo supera el límite de tamaño, o el formato no lo acepta el modelo. El texto del error rara vez los distingue.

Lo que ves

Por qué ocurre

Una imagen base64 enviada como image_url necesita la data URL completa, incluido el tipo de medio: data:image/png;base64,. Enviar solo el contenido es, con diferencia, la causa más común.

La herramienta base64 de la línea de comandos corta las líneas por defecto en muchos sistemas. Los saltos de línea incrustados hacen que el contenido no sea válido aunque parezca correcto. Usa la opción que desactiva el corte.

Los límites de tamaño se aplican al contenido codificado, que es aproximadamente un tercio más grande que el archivo en disco. Una imagen justo por debajo del límite en local puede superarlo en lo que se envía.

Comprueba si es esta la causa

Codifica sin cortar líneas y confirma que el prefijo está 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

Los primeros 40 caracteres deben empezar por data:image/png;base64,. Si el contenido ocupa muchos más bytes de lo esperado, el archivo en sí es demasiado grande.

Cómo solucionarlo

  1. Envía la data URL completaIncluye el esquema y el tipo de medio. Un PNG enviado con el tipo image/jpeg también es rechazado por algunos modelos, así que haz que coincida con el formato real.
  2. Desactiva el corte de líneas al codificarbase64 -w0 en Linux, o pásalo por tr -d para quitar los saltos de línea en macOS.
  3. Reduce la imagen antes de enviarlaLa mayoría de los modelos de visión la reducen internamente de todos modos. Enviar una foto de 12 megapíxeles te cuesta tiempo de subida y tokens sin mejorar la respuesta.
En APICLAN la imagen de entrada se cobra como tokens de entrada, y las imágenes más grandes cuestan más porque se convierten en más tokens. Reducirla antes de la llamada es un ahorro directo, no solo una forma de esquivar el límite.

Relacionado

Unexpected token '<' al llamar a una API compatible con OpenAI401 invalid API key: cuando la clave parece correcta pero sigue fallando

Revisado por última vez el 2026-10-01. Escrito a partir de problemas diagnosticados en una pasarela compatible con OpenAI en producción, no recopilado de otras webs.