Ideogram 4 Prompt Builder KJ (Ideogram4PromptBuilderKJ) - ComfyUI-KJNodes

Descripción

Constructor visual de prompts para el formato JSON estructurado de Ideogram 4.
Este nodo proporciona un editor interactivo dentro de ComfyUI que permite dibujar regiones en un lienzo, asignar etiquetas de objeto o texto, descripciones y paletas de colores, y luego ensamblar la cadena JSON final del caption compatible con el esquema esperado de Ideogram 4.

El editor admite arrastrar para dibujar regiones, selección, edición en línea, copiar/pegar/duplicar y controles completos de la barra de herramientas, incluida la gestión de imágenes de fondo, control deslizante de brillo, estimación de tokens y operaciones del portapapeles.

Entradas

Requerido

Nombre	Tipo	Predeterminado	Descripción
`width` (Ancho)	INT	`1024`	Ancho de aspecto del lienzo (también la cuadrícula de píxeles en la que se mide el bbox). Ideogram 4 necesita múltiplos de 16. Mín: 64, Máx: 16384, Paso: 16.
`height` (Alto)	INT	`1024`	Alto de aspecto del lienzo (también la cuadrícula de píxeles en la que se mide el bbox). Ideogram 4 necesita múltiplos de 16. Mín: 64, Máx: 16384, Paso: 16.
`high_level_description` (Descripción de alto nivel)	STRING	`""`	Resumen opcional de una línea de toda la imagen (en blanco = omitido).
`background` (Fondo)	STRING	`""`	Descripción requerida del fondo de la escena.
`style` (Estilo)	DYNAMICCOMBO	(dinámico)	Desplegable poblado por el editor (probablemente preajustes de estilo).
`aesthetics` (Estética)	STRING	`""`	Descriptor de estilo (en blanco = omitido).
`lighting` (Iluminación)	STRING	`""`	Descriptor de estilo (en blanco = omitido).
`medium` (Medio)	STRING	`""`	Descriptor de estilo (en blanco = omitido).
`style_palette_data` (Datos de paleta de estilo)	STRING	`""`	Paleta de colores de estilo serializada desde el editor (gestionada por la interfaz de usuario del nodo).
`elements_data` (Datos de elementos)	STRING	`""`	Regiones serializadas desde el editor (gestionadas por la interfaz de usuario del nodo).
`bg_brightness` (Brillo del fondo)	INT	`25`	Porcentaje de brillo de la imagen de fondo (gestionado por el control deslizante de la interfaz de usuario del nodo). Mín: 0, Máx: 100.
`import_mode` (Modo de importación)	COMBO	`"when empty"`	Cómo se usa un `import_json` conectado: `"when empty"` solo siembra el editor mientras no tiene regiones (luego el editor gana, por lo que puedes editar); `"always"` hace que el JSON conectado sea autoritativo, por lo que sus cambios siempre se propagan a la salida. Opciones: `["when empty", "always"]`.
`output_format` (Formato de salida)	STRING	`"compact"`	Formato del JSON de salida (configurado mediante la barra de herramientas del editor): `"compact"` (predeterminado, lo que espera Ideogram 4) o `"pretty"` (con sangría, para legibilidad).
`coord_mode` (Modo de coordenadas)	STRING	`"normalized"`	Espacio de coordenadas del bbox (configurado mediante la barra de herramientas del editor): `"normalized"` (predeterminado, la cuadrícula 0-1000 que espera Ideogram 4) o `"absolute"` (píxeles, escalados por ancho/alto — NO ESTÁNDAR para Ideogram, para otras herramientas que quieren coordenadas de píxeles).
`bbox_order` (Orden del bbox)	STRING	`"yx"`	Orden de ejes del bbox (configurado mediante la barra de herramientas del editor): `"yx"` (predeterminado, el `[ymin, xmin, ymax, xmax]` de Ideogram) o `"xy"` (`[xmin, ymin, xmax, ymax]`, el x1,y1,x2,y2 estándar que usan Qwen-VL y la mayoría de los detectores).
`photo` (Foto)	STRING	`""`	(sin descripción en la fuente)
`art_style` (Estilo artístico)	STRING	`""`	(sin descripción en la fuente)

Opcionales

Nombre	Tipo	Predeterminado	Descripción
`image` (Imagen)	IMAGE	—	Imagen de referencia opcional que se muestra como fondo del editor (y detrás de la vista previa).
`import_json` (Importar JSON)	STRING	`""`	Opcional: un JSON de caption completo. Cuando está conectado, se carga en el editor y controla la salida según `import_mode`.
`bboxes` (Bboxes)	BOUNDINGBOX	—	Cajas opcionales en espacio de píxeles (`{x, y, width, height}`) utilizadas para sembrar las regiones del editor cuando no tiene ninguna. Se ignora una vez que existen regiones.

Salidas

Índice	Tipo	Descripción
0	`STRING`	La cadena JSON del caption ensamblada en el formato elegido (compacto o bonito).
1	`IMAGE`	(probablemente la imagen de vista previa/fondo, reutilizada o capturada mediante la barra de herramientas)
2	`BOUNDINGBOX`	(quizás las cajas delimitadoras del editor en forma de píxeles o normalizada)
3	`INT`	(Desconocido, posiblemente recuento de tokens o recuento de regiones)
4	`INT`	(Desconocido)

Notas de uso / Funciones del editor

Controles del lienzo
- Arrastrar: dibujar una nueva región.
- Ctrl/Cmd+arrastrar: forzar el dibujo de una nueva región incluso sobre una existente.
- Clic: seleccionar una región.
- Alt+clic: alternar entre regiones superpuestas.
- Doble clic: editar la descripción en línea.
- Clic derecho: lista de regiones (seleccionar / eliminar / duplicar / reordenar; arriba = frente).
- Supr / Retroceso: eliminar la región seleccionada.
- Ctrl/Cmd + C / V / D: copiar / pegar / duplicar la región seleccionada.
- Los campos bbox (px / out) junto a obj/text son editables.
Muestras de color
- Clic: editar.
- Arrastrar: reordenar.
- Clic derecho: eliminar.
- Pasar el cursor + Ctrl/Cmd + C / V: copiar / pegar el hex.
- "+": agregar un color (usa el color del portapapeles si está presente).
Barra de herramientas
- Vista previa de muestreo en vivo: usar la vista previa de muestreo en vivo como fondo (y capturar el resultado final).
- Capturar fondo / Limpiar fondo: usar la última imagen generada como fondo.
- Control deslizante de brillo, estimación de tokens y Copiar / Pegar / Borrar todo.
Cajas delimitadoras se normalizan a una cuadrícula de 0–1000 como [ymin, xmin, ymax, xmax] por defecto; width y height definen la relación de aspecto del lienzo.
Comportamiento del modo de importación:
- "when empty": Solo importa el JSON si el editor aún no tiene regiones. Una vez que editas, el editor toma el control.
- "always": El JSON conectado es autoritativo; cualquier cambio en el JSON fuerza la salida, sobrescribiendo el estado del editor.
Modos de coordenadas y orden del bbox son configurables para compatibilidad con diferentes modelos posteriores. Ideogram 4 espera "normalized" y "yx".
Formato de salida: "compact" (sin espacios en blanco) es lo que espera Ideogram 4; "pretty" (con sangría) es para legibilidad humana.
Entrada image es opcional y proporciona un fondo de referencia en el editor, pero no afecta al JSON generado.
Las entradas style_palette_data, elements_data y bg_brightness son estado serializado interno – la interfaz de usuario del nodo las gestiona automáticamente al interactuar con el editor.
Tanto photo como art_style son campos de cadena adicionales que pueden asignarse a la estructura de caption de Ideogram 4 (sin más detalles en la fuente).

Ideogram 4 Prompt Builder KJ(Ideogram4PromptBuilderKJ)