gpt-5.4 para la comprensión de imágenes y grok-imagine-image para la generación de imágenes.
Comprensión de imágenes
Envía una URL de imagen pública o lee un archivo local y pásalo como datos en Base64.
Generación de imágenes
Genera una imagen a partir de una indicación y guarda localmente los datos en Base64 devueltos.
Edición de imágenes
Edita una imagen existente cuando el modelo seleccionado lo admita.
Consejos para las indicaciones
Describe el tema, el estilo, la composición y las restricciones.
Comprensión de imágenes
La comprensión de imágenes usa el endpointchat/completions compatible con OpenAI. Puedes pasar una URL de imagen pública o codificar una imagen local en Base64 y enviarla como un URI data:. Los ejemplos usan gpt-5.4.
Usar una imagen local
Los ejemplos con imágenes locales leen el archivo, lo convierten a Base64 y luego lo envían en la solicitud. En el ejemplo de Python,IMAGE_PATH = "photo.jpg" significa que la imagen está en la misma carpeta del proyecto que el archivo de Python y su nombre debe coincidir exactamente, incluyendo la extensión y las mayúsculas o minúsculas. Usa una ruta local completa cuando la imagen esté en otro lugar. El ejemplo de Node.js usa const IMAGE_PATH = "photo.png"; coloca la imagen en la misma carpeta del proyecto que el archivo .mjs y ejecuta el comando desde esa carpeta. Cambia tanto IMAGE_PATH como IMAGE_MIME_TYPE cuando el nombre de archivo o el formato sean diferentes.
Para la instalación de dependencias de Python y Node.js, la ejecución de ejemplos y la solución de problemas del entorno, consulta FAQ.
Generación de imágenes
La generación de imágenes usa el endpoint/v1/images/generations compatible con OpenAI. Los ejemplos usan grok-imagine-image. La compatibilidad con el tamaño, la cantidad de resultados y el formato de respuesta varía según el modelo, así que confirma el nombre del modelo y el precio en Model Square antes de integrarlo.
Edición de imágenes
Usa la edición de imágenes para modificar una imagen existente, como reemplazar un fondo, cambiar un área local o ajustar el estilo general. El endpoint, el formato de carga de archivos y los parámetros dependen del modelo seleccionado. Confirma que el modelo admita la edición de imágenes en Model Square antes de llamarlo.Consejos para las indicaciones
- Describe el tema, el estilo, la composición, la iluminación, la paleta de colores y el fondo.
- Indica el uso previsto y las restricciones, como la relación de aspecto o los elementos que se deben mantener o evitar.
- Combina la comprensión de imágenes con salida estructurada cuando el código posterior necesite campos estables.
Notas de facturación
- La comprensión de imágenes generalmente cuenta la entrada de imágenes como tokens. Las imágenes más grandes o más detalladas consumen más tokens.
- La generación y edición de imágenes puede facturarse por imagen, por tamaño o por unidades específicas del modelo.
Notas
- Usa únicamente modelos marcados como compatibles con la capacidad requerida en Model Square.
- Las imágenes grandes pueden consumir más tokens o ser rechazadas; comprímelas cuando sea necesario.
- Las URL de las imágenes deben ser de acceso público.
