> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI GPT Image 2.5 - ComfyUI Built-in Node Documentation

> Este nodo genera imágenes mediante la API GPT Image de OpenAI.

Este nodo genera imágenes mediante la API GPT Image de OpenAI. Admite cinco modelos —`gpt-image-2.5-flare`, `gpt-image-2.5-sunburst`, `gpt-image-2`, `gpt-image-1.5` y `gpt-image-1`—, permite adjuntar imágenes de referencia para la edición de imágenes y puede usar una máscara para especificar qué partes de una imagen se deben reemplazar.

## Entradas

### Entradas comunes

Estas entradas siempre están visibles.

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `modelo` | El modelo OpenAI GPT Image que se usará. Al seleccionar un modelo, se revelan parámetros adicionales específicos de ese modelo. | DYNAMIC\_COMBO | Sí | `"gpt-image-2.5-flare"` `"gpt-image-2.5-sunburst"` `"gpt-image-2"` `"gpt-image-1.5"` `"gpt-image-1"` |
| `prompt` | Indicación de texto para GPT Image (predeterminado: `""`). | STRING | Sí | N/A |
| `n` | Cuántas imágenes generar (predeterminado: `1`). | INT | Sí | 1 a 8 |
| `semilla` | Semilla para reproducibilidad (predeterminado: `0`). Aún no implementado en el backend. | INT | Sí | 0 a 2147483647 |

### Entradas de gpt-image-2.5-flare y gpt-image-2.5-sunburst

Estas entradas aparecen cuando `model` se establece en `gpt-image-2.5-flare` o `gpt-image-2.5-sunburst`. Ambos modelos comparten el mismo conjunto de parámetros.

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `tamaño` | Tamaño de imagen. Seleccione "Custom" para usar el ancho y el alto personalizados (predeterminado: `"auto"`). | COMBO | Sí | `"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"` |
| `ancho_personalizado` | Se usa solo cuando `model.size` es "Custom". Debe ser múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) |
| `altura_personalizada` | Se usa solo cuando `model.size` es "Custom". Debe ser múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) |
| `fondo` | Devuelve la imagen con o sin fondo (predeterminado: `"auto"`). | COMBO | Sí | `"auto"` `"opaque"` `"transparent"` |
| `calidad` | Calidad de imagen; afecta el costo y el tiempo de generación (predeterminado: `"low"`). | COMBO | Sí | `"low"` `"medium"` `"high"` `"xhigh"` `"max"` |
| `model.images` | Imagen o imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para obtener más detalles. | IMAGE | No | 0 a 16 |
| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A |

### Entradas de gpt-image-2

Estas entradas aparecen cuando `model` se establece en `gpt-image-2`.

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `tamaño` | Tamaño de imagen. Seleccione "Custom" para usar el ancho y el alto personalizados (predeterminado: `"auto"`). | COMBO | Sí | `"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` `"2048x2048"` `"2048x1152"` `"1152x2048"` `"3840x2160"` `"2160x3840"` `"Custom"` |
| `ancho_personalizado` | Se usa solo cuando `model.size` es "Custom". Debe ser múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) |
| `altura_personalizada` | Se usa solo cuando `model.size` es "Custom". Debe ser múltiplo de 16 (predeterminado: `1024`). | INT | No | 480 a 3840 (paso 16) |
| `fondo` | Devuelve la imagen con o sin fondo (predeterminado: `"auto"`). | COMBO | Sí | `"auto"` `"opaque"` |
| `calidad` | Calidad de imagen; afecta el costo y el tiempo de generación (predeterminado: `"low"`). | COMBO | Sí | `"low"` `"medium"` `"high"` |
| `model.images` | Imagen o imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para obtener más detalles. | IMAGE | No | 0 a 16 |
| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A |

### Entradas de gpt-image-1.5 y gpt-image-1

Estas entradas aparecen cuando `model` se establece en `gpt-image-1.5` o `gpt-image-1`. Ambos modelos comparten el mismo conjunto de parámetros.

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `tamaño` | Tamaño de imagen (predeterminado: `"auto"`). | COMBO | Sí | `"auto"` `"1024x1024"` `"1024x1536"` `"1536x1024"` |
| `fondo` | Devuelve la imagen con o sin fondo (predeterminado: `"auto"`). | COMBO | Sí | `"auto"` `"opaque"` `"transparent"` |
| `calidad` | Calidad de imagen; afecta el costo y el tiempo de generación (predeterminado: `"low"`). | COMBO | Sí | `"low"` `"medium"` `"high"` |
| `model.images` | Imagen o imágenes de referencia opcionales para la edición de imágenes. Hasta 16 imágenes. Consulte Entradas de referencia para obtener más detalles. | IMAGE | No | 0 a 16 |
| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A |

### Entradas de referencia

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `model.images` | Ranura ampliable: conecte de 1..N elementos (p. ej., `image_1`...`image_16`); hasta 16 imágenes de referencia para todos los modelos. | IMAGE | No | 0 a 16 |
| `model.mask` | Máscara opcional para inpainting (las áreas blancas se reemplazarán). Requiere exactamente una imagen de referencia. | MASK | No | N/A |

**Restricciones y limitaciones de los parámetros:**

* Cuando `model.size` es "Custom" (solo `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst` y `gpt-image-2`), `model.custom_width` y `model.custom_height` deben ser ambos múltiplos de 16, el borde más largo no debe superar 3840, la relación de aspecto no debe superar 3:1 y la cantidad total de píxeles debe estar entre 655.360 y 8.294.400.
* `model.mask` requiere exactamente una imagen de referencia en `model.images`: no se puede usar sin una imagen y no se puede usar con más de una imagen.
* Cuando se usa `model.mask`, su altura y anchura deben coincidir con la altura y anchura de la imagen de referencia.
* Cuando se proporciona `model.images`, el nodo se ejecuta en modo de edición de imágenes; sin `model.images`, genera imágenes solo a partir del prompt.
* Las imágenes de referencia y la máscara se reescalan a una resolución menor antes de enviarse a la API.
* Los niveles de calidad `"xhigh"` y `"max"` solo están disponibles para `gpt-image-2.5-flare` y `gpt-image-2.5-sunburst`.
* `seed` actualmente no está implementado en el backend.

## Salidas

| Nombre de salida | Descripción | Tipo de datos |
| - | - | - |
| `image` | La imagen o imágenes generadas. Todas las imágenes devueltas se apilan en un lote; si sus dimensiones difieren, se redimensionan para coincidir con la primera imagen. | IMAGE |

> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/OpenAIGPTImageNodeV2/es.md)

***

**Source fingerprint (SHA-256):** `9cf1a9fa3e2cd98aff6c42432164ac5e6c55b7bcdc9815043cb359c6968ac172`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.