Recetas de prompts de texto a imagen para desarrolladores con Recraft v4.1

Por qué las recetas de prompts superan a los prompts desechables

Todo equipo que llama a una API de texto a imagen acaba chocando con el mismo muro: la imagen que funcionaba de maravilla tiene su prompt enterrado en un historial de chat, un script desechable o la aplicación de notas de alguien. Cuando cambia un requisito de producto —«la misma ilustración, pero con aspecto fotográfico» o «añade un titular dentro de la imagen»—, nadie sabe qué palabras hicieron el trabajo, así que el prompt se reescribe desde cero y la salida cambia de forma impredecible.

Una receta de prompt resuelve esto tratando el prompt como un pequeño documento parametrizado. Un esqueleto, unos pocos bloques sustituibles y una lista breve de restricciones. Cambiar el estilo pasa a ser la edición de un solo campo en lugar de una reescritura completa, lo que significa que puedes hacer diff de tus prompts, revisarlos en un pull request y razonar sobre por qué cambió la salida.

Las recetas también hacen depurables las regresiones de calidad. Si las imágenes empiezan a verse mal de repente, puedes bisecar: ¿es el bloque de sujeto, el de estilo, la instrucción de diseño o la lista negativa? Con un prompt desechable, la respuesta suele ser «todo a la vez».

Esta guía recorre un esqueleto concreto para texto a imagen con Recraft v4.1 y ofrece las dos familias de recetas copiables que más usan los desarrolladores: ilustración y fotografía. La misma estructura se extiende al control de diseño, el texto dentro de la imagen y las listas negativas.

Qué contiene realmente una receta

Piensa en cada receta como cuatro partes:

• El esqueleto fijo: los bloques ordenados que comparten todos los prompts de tu repositorio.
• El vocabulario de estilo sustituible: las palabras que alternan la salida entre ilustración y fotografía.
• Las cláusulas de restricción: instrucciones de diseño, relación de aspecto, representación de texto y exclusión.
• La etiqueta de versión: lo que hace que un prompt en producción se remonte a la revisión exacta que generó ese material.

Nada de esto requiere herramientas especiales. Un archivo JSON por receta, confirmado en el repositorio junto al código que llama a la API, es suficiente.

El esqueleto del prompt: qué bloques se mantienen y cuáles cambian

El esqueleto de abajo es deliberadamente aburrido. Ese es justamente el punto: las partes estables nunca deberían necesitar edición, para que la atención se concentre en lo que sí cambia.

[SUBJECT]        qué hay en la imagen, descrito en lenguaje llano
[STYLE]          vocabulario de medio y renderizado
[COMPOSITION]    encuadre, cámara o diseño, relación de aspecto
[CONSTRAINTS]    representación de texto, límites de color, reglas de exclusión

Qué bloques se mantienen y cuáles se sustituyen

• SUBJECT: se mantiene. Suele ser el único bloque que tu lógica de producto debería parametrizar (un nombre de producto, una descripción de escena procedente de la entrada del usuario).
• STYLE: se sustituye. La diferencia entre ilustración y fotografía está casi toda aquí.
• COMPOSITION: se sustituye en su mayor parte, pero la forma de la instrucción no cambia (primero encuadre, después relación de aspecto).
• CONSTRAINTS: se comparte en parte. Las reglas de la lista negativa y de «nada de texto salvo que se especifique» suelen ser globales; las instrucciones de representación de texto dependen de cada petición.

La plantilla mínima como datos

{
  "recipe_id": "product-hero",
  "version": "3",
  "subject": "a ceramic coffee mug on a plain surface",
  "style": "{{style_block}}",
  "composition": "centered, generous negative space above the subject, square aspect",
  "constraints": ["no text in image", "no watermark"],
  "negatives": "{{negative_list_v2}}"
}

El marcador {{style_block}} es la costura. El resto se comparte entre recetas o lo aporta quien llama. Cuando más adelante añadas un tercer estilo —por ejemplo, 3D isométrico—, añades un bloque de estilo, no un archivo de prompt nuevo.

Un recordatorio práctico: mantén el orden de los bloques igual en todas las recetas. No hay garantía de que el modelo sea sensible al orden de forma documentada, pero tu equipo sí lo es. Un orden consistente hace comparables los prompts y da sentido a las revisiones en paralelo.

Recetas de ilustración: estilos plano, vectorial y editorial

La receta de ilustración es el punto de partida de la mayoría de los equipos porque la ilustración tolera bien la simplificación, lo que la convierte en una buena opción para probar el esqueleto sin pelearse con el realismo.

Ilustración plana

[SUBJECT] a developer workspace with a laptop, notebook and coffee mug
[STYLE] flat vector illustration, solid fills, no gradients, bold simple shapes, limited four-color palette, clean geometric forms
[COMPOSITION] centered composition, even margins, square aspect
[CONSTRAINTS] no text in image, no shadows, no textures

Las palabras que producen este aspecto: plana, rellenos sólidos, sin degradados, formas audaces y simples. Cada palabra hace su trabajo. Quita «sin degradados» y a menudo verás colarse sombras suaves.

Iconos de estilo vectorial

[SUBJECT] a single shield icon with a checkmark
[STYLE] minimal vector icon, uniform stroke weight, rounded line caps, two-tone, high contrast on plain background
[COMPOSITION] centered, icon fills most of the frame, square aspect
[CONSTRAINTS] no text, no background scenery, no gradients

Los prompts de icono se benefician de calificadores explícitos —único, grosor de trazo uniforme— porque sin ellos a menudo obtienes una pequeña escena en lugar de un símbolo gráfico.

Ilustración editorial

[SUBJECT] a person reviewing charts on a large screen
[STYLE] editorial illustration, muted palette, subtle grain, hand-drawn line quality, slightly abstracted human figures, magazine feature style
[COMPOSITION] subject offset to the right, breathing room on the left, landscape aspect
[CONSTRAINTS] no text in image, no photorealism, no logos

El estilo editorial ocupa una zona intermedia: más texturizado y con más personalidad que el vector plano, pero claramente no fotografía. Combinar paleta apagada con grano sutil es lo que impide que se deslice hacia cualquiera de los dos extremos.

Consejo de ajuste: cambia un solo adjetivo de estilo a la vez. Cambiar «paleta apagada» por «paleta vibrante» es un experimento real; cambiar cinco palabras a la vez no lo es.

Recetas de fotografía: realismo, estudio y encuadres de estilo de vida

Las recetas de fotografía usan el mismo esqueleto, solo cambia el vocabulario. Fíjate en que el bloque de sujeto apenas se toca: esa es la recompensa de la plantilla.

Producto limpio en estudio

[SUBJECT] a ceramic coffee mug on a plain surface
[STYLE] professional studio product photography, soft diffused key light, gentle falloff, neutral background, sharp focus, realistic material detail
[COMPOSITION] centered, slight three-quarter angle, generous negative space above, square aspect
[CONSTRAINTS] no text in image, no props, no harsh reflections

El vocabulario fotográfico se agrupa en torno a la luz (difusa suave, caída gradual), la óptica (enfoque nítido, profundidad de campo) y el realismo de materiales (detalle realista de materiales). El vocabulario de ilustración se agrupa en torno a forma y relleno. Ese contraste es toda la diferencia entre las dos familias de recetas.

Estilo de vida en entorno real

[SUBJECT] a person working at a wooden desk near a window
[STYLE] candid lifestyle photography, natural window light, shallow depth of field, warm neutral tones, realistic skin and fabric texture
[COMPOSITION] over-the-shoulder framing, subject left of center, landscape aspect
[CONSTRAINTS] no text in image, no visible brand marks, no exaggerated saturation

Candid y luz natural de ventana alejan la salida del acabado pulido de estudio. Si el resultado parece demasiado posado, a menudo es tanto un problema de composición como de estilo: añadir «encuadre por encima del hombro» funciona mejor que acumular más adjetivos.

Convertir una receta de ilustración en fotografía

Dada una receta de ilustración que funciona, la conversión es mecánica:

1. Sustituye todo el bloque [STYLE] por vocabulario fotográfico.
2. Ajusta [COMPOSITION] solo si cambia el encuadre (el ángulo importa más en fotografía).
3. Mantén [SUBJECT] idéntico byte a byte.
4. Conserva los negativos globales; elimina los específicos de ilustración que ya no apliquen, como «sin degradados».

Si el resultado fotográfico inventa o pierde elementos del sujeto, lo más probable es que el bloque de sujeto esté poco descrito: corrígelo ahí, no añadiendo palabras de estilo compensatorias.

Controlar el diseño y la representación de texto

El diseño y el texto son las dos cosas que los desarrolladores suelen esperar que el modelo deduzca, y también las dos que más merece la pena escribir de forma explícita. Trátalos como bloques de prompt independientes, separados del estilo.

Lenguaje de posición que de verdad restringe

Vago: «una imagen de banner para una landing page».

Explícito:

[COMPOSITION] landscape 16:9 frame; subject occupies the right two-thirds;
left third is empty open space suitable for a headline; horizon line at
lower third; nothing enters the left third

Tres hábitos hacen más firmes las instrucciones de posición:

• Nombra primero el marco, luego describe la colocación («marco horizontal 16:9»).
• Declara explícitamente la zona reservada y afirma que nada entra en ella. El espacio vacío no es el estado por defecto.
• Ancla a las líneas de los tercios, en lugar de usar términos no medibles como «ligeramente descentrado».

Representación de texto

Cuando quieras texto dentro de la imagen, aíslalo en un bloque y cita la cadena exacta:

[TEXT] render exactly the words "Ship faster" in a bold sans-serif,
placed in the reserved left third, vertically centered, single line,
high contrast against a plain background. No other text anywhere.

Puntos que reducen iteraciones:

• Cita la cadena literal; nunca la parafrasees dentro del prompt.
• Di «exactamente» y «nada de otro texto»; de lo contrario aparecerán palabras sobrantes en esquinas o accesorios.
• Especifica el número de líneas («una sola línea»), o los saltos de línea serán una incógnita.
• Especifica un fondo de contraste («sobre un fondo liso») para que el texto tenga algo sobre lo que apoyarse.
• Mantén el texto completamente fuera del bloque [STYLE]; mezclarlos dificulta el ajuste de ambos.

Si una petición necesita composición tipográfica precisa con varios elementos, trata el texto generado como punto de partida y planifica una capa de texto real aguas abajo. El control de texto a nivel de prompt sirve para titulares cortos y etiquetas, no para cuerpo de texto denso.

Listas negativas: qué excluir y cómo versionarlo

La lista negativa es tu control de calidad más barato. En lugar de describir lo que quieres, nombras los modos de fallo que te niegas a aceptar.

Categorías que vale la pena excluir

Organiza los negativos por categoría para poder ampliarlos sin crear contradicciones:

• Artefactos de texto: palabras sobrantes, glifos ilegibles, marcas de agua, firmas.
• Artefactos de composición: sujetos recortados, extremidades cortadas, elementos duplicados, bordes desordenados.
• Artefactos de renderizado: desenfoque, bandas de color, sobresaturación, aspecto HDR agresivo, piel con aspecto plástico.
• Higiene de contenido: logotipos de marca, marcas comerciales reconocibles, retratos de personas reales.
• Deriva de estilo: fotorrealismo en una receta de ilustración, aspecto de ilustración en una receta de fotografía.

La última categoría es la que más olvidan los equipos. Si tu receta de ilustración deriva continuamente hacia el realismo, un negativo explícito suele ser más fiable que acumular adjetivos de estilo.

Mantenerla corta y sin contradicciones

Las listas negativas demasiado largas se vuelven contraproducentes. Si un negativo entra en conflicto con una instrucción positiva, el resultado se vuelve inestable y no puedes saber qué cláusula prevaleció. Dos reglas:

1. Nunca niegues algo que pediste. Si el bloque de composición pide sombras para dar profundidad, no incluyas a la vez «sin sombras» de forma global.
2. Lo específico gana a lo genérico. «Sin marca de agua» es accionable; «nada malo» es ruido.

Versionar la lista negativa junto al prompt

Los negativos cambian el comportamiento de todas las recetas que los referencian, así que necesitan la misma trazabilidad que los prompts:

{
  "negative_list_id": "global-v2",
  "entries": ["watermark", "signature", "stray text", "cropped subject", "duplicated elements", "oversaturated colors"]
}

Referencia la lista por ID desde cada receta e incrementa el ID al editarla. Cuando la calidad de salida se desplaza tras un despliegue, «¿cambió la lista negativa?» pasa a ser una línea que revisar en el diff y no una investigación.

Comparar con salidas reales antes de lanzar

Antes de que hayas mirado salidas reales, una receta es solo una hipótesis. El flujo de comparación de abajo es deliberadamente ligero: debería llevar unos minutos, no un sprint.

El flujo

1. Congela todo menos una variable. El mismo bloque de sujeto, la misma composición, los mismos negativos y, si la API expone una semilla, la misma semilla. Cambia solo el bloque de estilo.
2. Genera una matriz pequeña. Dos o tres variantes de estilo con dos o tres sujetos representativos suele bastar para exponer una receta mala.
3. Revisa en paralelo, no en secuencia. La revisión secuencial invita al sesgo de recencia: la última imagen parece la mejor solo porque es la más reciente.
4. Puntúa contra el requisito, no contra el gusto. Escribe para qué sirve el material (banner principal, conjunto de iconos, cabecera editorial) y comprueba los atributos concretos que importan: ¿el espacio reservado está realmente vacío?, ¿hay texto sobrante?, ¿hay deriva de estilo?
5. Promociona de forma deliberada. Solo la revisión de receta que pasa la revisión entra en el código de producto, etiquetada con su versión.

Qué observar

• Consistencia entre sujetos. Un bloque de estilo que funciona con un sujeto y se rompe con otro aún no está listo.
• Cumplimiento de restricciones. ¿El tercio izquierdo reservado sigue vacío? ¿La cadena exacta citada aparece una sola vez?
• Fallos agrupados. Si el mismo artefacto aparece en varias variantes, va a la lista negativa, no a un ajuste fino de estilo.

Guardar todo en el repositorio

Mantén juntos el JSON de la receta, las versiones de la lista negativa y los registros de revisión. Cuando alguien pregunte dentro de seis meses por qué la imagen principal es así, la respuesta es un commit, no un recuerdo.

Una vez que una receta pasa este ciclo, alternar entre ilustración y fotografía para un sujeto dado se convierte en la edición de un solo campo: justo la propiedad de mantenimiento que el esqueleto estaba destinado a ofrecer. Ejecuta estas recetas con el texto a imagen de Recraft v4.1 a través de una API unificada y versiona cada revisión de prompt junto al código que la llama.