Guía de uso

Genera imágenes de producto de comercio electrónico con flux-2-klein-9b/text-to-image a través de la API de hiapi

Aug 14, 2026

La mayoría de los modelos de texto a imagen rápidos y baratos te obligan a elegir: o el texto de la imagen es nítido y legible, o el precio es bajo. flux-2-klein-9b/text-to-image es uno de los pocos modelos del nivel «barato y rápido» que no te obliga a elegir entre ambos. La etiqueta que le asigna hiapi es Text Rendering, High Fidelity (renderizado de texto, alta fidelidad), y en la práctica esto significa que puede renderizar en una misma generación un logotipo de marca con texto, una pequeña etiqueta con letras y un llamativo titular promocional grande, sin necesidad de una segunda pasada para corregir letras distorsionadas.

Esto es especialmente importante para las imágenes de producto de comercio electrónico: precisamente las imágenes que realmente necesitan texto —la imagen principal con una etiqueta visible, el banner de promoción por tiempo limitado con el precio anotado— son las que los modelos «rápidos» y económicos suelen estropear con más facilidad.

En este artículo, las tres imágenes se generaron con flux-2-klein-9b/text-to-image, sin reintentos: el texto de la etiqueta, el gran titular promocional y la línea con la información del descuento salieron limpios y sin errores en la primera generación. Esto no significa que todos los prompts puedan garantizar lo mismo (véanse las advertencias de revisión más abajo), pero para un modelo de este precio es una buena señal.

Precios: comparación entre flux-2-klein-9b y flux-2-klein-4b (texto a imagen)

Ambos modelos pertenecen a la familia «Klein» y ambos apuestan por la rapidez y el bajo coste. La diferencia está en qué compras con tu dinero:

Modelo	Precio por imagen	Etiquetas
`flux-2-klein-9b/text-to-image`	Precio único de $0.00858	Text-to-Image, Text Rendering, High Fidelity
`flux-2-klein-4b/text-to-image`	Precio único de $0.00143	Text-to-Image, Fast, Cost Efficient

(Precios a fecha de 2026-08, verificados con /api/pricing.)

flux-2-klein-4b/text-to-image es aproximadamente 6 veces más barato: una buena opción por defecto para fondos, imágenes de estilo de vida o cualquier imagen en la que el texto no forme parte de la composición. Pero no tiene la etiqueta de renderizado de texto, así que si el texto de una tarjeta, una etiqueta o un banner debe ser realmente nítido y legible, klein-9b es la opción más segura aunque cueste más. Y a menos de un centavo por imagen, esa «seguridad» aquí sigue siendo más barata que una sola llamada a la API de la mayoría de los LLM.

Una solicitud real

A continuación se muestra una solicitud funcional al endpoint /v1/tasks para generar una tarjeta promocional con texto renderizado:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Banner promocional para redes sociales de una promoción flash de comercio electrónico: un frasco gotero de vidrio esmerilado con la etiqueta 'VELURA HYDRA SERUM', centrado sobre un fondo de degradado suave que pasa del rosa rubor al color crema, en la parte superior un titular grande en negrita y limpio de tipografía sans serif con el texto 'FLASH SALE', letras en gris carbón oscuro, debajo una línea de texto más pequeña con el texto '30% OFF', con la misma tipografía, en la esquina inferior derecha una insignia rectangular redondeada de línea fina que contiene el texto 'VELURA', maquetación clara y legible, espacio en blanco equilibrado, diseño de marketing moderno y minimalista, sin otro texto, sin marca de agua",
      "aspect_ratio": "1:1"
    }
  }'

La solicitud devuelve un taskId. Consulta repetidamente GET /v1/tasks/{taskId} hasta que status sea success y luego descarga output[0].url: los enlaces firmados caducan, así que recupera los bytes de inmediato y guárdalos por tu cuenta.

Notas sobre el esquema: lo que funciona en la práctica

Antes de desarrollar sobre este modelo, conviene conocer algunos puntos, basados en lo que la API acepta realmente (no solo en la documentación):

resolution se rechaza. A diferencia de otros modelos de imagen de hiapi, enviar el campo resolution devuelve un 400 (additional properties not allowed). Envía solo aspect_ratio.
aspect_ratio es una lista corta y fija: 1:1, 4:3, 3:4, 16:9, 9:16. No hay 4:5 ni 21:9: si tu maquetación busca un recorte vertical más alto, 3:4 es la proporción admitida más cercana (es la que usamos para la imagen de estilo de vida más abajo).
aspect_ratio es opcional en sí. Si lo omites por completo, igualmente se genera una imagen válida usando el valor predeterminado del servidor; pero en el trabajo de comercio electrónico casi siempre querrás un formato definido (cuadrado para publicaciones de feed, 16:9 para banners principales), así que conviene establecerlo explícitamente en lugar de depender del valor predeterminado.
Precio único por imagen, sin tramos por resolución. A diferencia de flux-2-klein-4b/image-to-image (con cinco tramos de precio según megapíxeles), klein-9b/text-to-image tiene una tarifa única independientemente de la relación de aspecto.

Prompt + resultado: imagen principal

Prompt (16:9, usado tal cual, sin modificaciones tras la generación):

Imagen principal de producto de comercio electrónico: un frasco gotero de vidrio esmerilado lleno de un sérum facial de alta gama sobre una losa de mármol gris húmeda, luz solar suave desde la izquierda que proyecta un reflejo tenue, fondo beige minimalista, pequeñas gotas de agua sobre el mármol, la etiqueta del frasco dice claramente 'VELURA' con una tipografía serif moderna y limpia, debajo un texto más pequeño 'HYDRA SERUM', fotografía de producto profesional de estudio, enfoque nítido, luz de contorno sutil, sin otro texto, sin manos, sin marca de agua ni logotipo

(La imagen es la que se muestra al principio del artículo.) El nombre de la marca y la línea de producto se renderizan limpios a una distancia de lectura normal: sin letras duplicadas, sin serifas derretidas, que es precisamente el modo de fallo habitual de los modelos de texto a imagen baratos de este nivel de precio.

Prompt + resultado: escena de estilo de vida

Prompt (3:4):

Fotografía de comercio electrónico de estilo de vida: un frasco gotero de vidrio esmerilado con la etiqueta 'VELURA HYDRA SERUM', colocado sobre la encimera luminosa de un baño, junto a una toalla blanca doblada y una pequeña ramita de eucalipto en maceta, luz cálida de la mañana entrando por la ventana, sombras suaves, profundidad de campo reducida, estilismo natural y espontáneo, el texto de la etiqueta del frasco 'VELURA' y 'HYDRA SERUM' se mantiene nítido y claramente legible, sin personas, sin manos, sin superposiciones de texto adicionales

Las imágenes de estilo de vida como esta normalmente no necesitan texto en la imagen, pero la etiqueta debe resistir condiciones de iluminación más suaves y difusas que en la imagen principal de estudio, y eso es una prueba más difícil para la fidelidad del texto del modelo.

Prompt + resultado: tarjeta de promoción por tiempo limitado

Prompt (1:1):

Banner promocional para redes sociales de una promoción flash de comercio electrónico: un frasco gotero de vidrio esmerilado con la etiqueta 'VELURA HYDRA SERUM', centrado sobre un fondo de degradado suave que pasa del rosa rubor al color crema, en la parte superior un titular grande en negrita y limpio de tipografía sans serif con el texto 'FLASH SALE', letras en gris carbón oscuro, debajo una línea de texto más pequeña con el texto '30% OFF', con la misma tipografía, en la esquina inferior derecha una insignia rectangular redondeada de línea fina que contiene el texto 'VELURA', maquetación clara y legible, espacio en blanco equilibrado, diseño de marketing moderno y minimalista, sin otro texto, sin marca de agua

Esta es la imagen que realmente pone a prueba la etiqueta «Text Rendering, High Fidelity» del modelo: dos líneas de titular grande más el texto de una pequeña insignia, todo en una sola generación. Todas las palabras están bien escritas y el espaciado entre letras se mantiene correcto, pero precisamente por eso deberías revisarla tú mismo antes de publicarla (véase más abajo).

No te saltes la revisión

La propia guía de contenido de hiapi lo dice sin rodeos: el renderizado de texto por IA es «99%, no 100%». Incluso los modelos con la etiqueta de texto de alta fidelidad a veces escriben mal una palabra, omiten una letra o juntan dos palabras, especialmente con textos pequeños de etiqueta frente a titulares grandes (lo pequeño es más difícil). Antes de publicar una tarjeta promocional o una etiqueta de producto generada:

Amplía al 100 % cada línea de texto renderizado.
Comprueba la ortografía y el espaciado, no solo que «parezca texto».
Si algo no está bien, vuelve a generar: no edites los píxeles a mano, porque repetir la generación cuesta una fracción de céntimo.
Para textos que cambian con frecuencia (precios, fechas de promoción), considera superponerlos en tu propio paso de plantilla en lugar de incluirlos en cada generación: actualizar es más barato y elimina por completo el riesgo de tener que repetir la generación.

Generación por lotes con Python

Para un catálogo de productos completo, envuelve el mismo patrón de solicitud en un bucle:

import requests
import time

API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt, aspect_ratio="1:1"):
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "flux-2-klein-9b/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
        },
    )
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(
            f"{BASE}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        ).json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(task["error"])
        time.sleep(5)

prompts = [
    ("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
    ("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
    ("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]

for prompt, ratio in prompts:
    url = generate(prompt, ratio)
    print(url)  # download immediately — the URL expires

A $0.00858 por imagen, un catálogo de 50 SKU con 3 imágenes por SKU (principal, estilo de vida, promoción) suma aproximadamente $1.29 en total: frente a una sesión de fotografía de producto freelance, esto es prácticamente calderilla.

Comparación de flux-2-klein-9b/text-to-image con otros flujos de trabajo relacionados

Si estás montando un pipeline de imágenes de producto más completo en hiapi, merece la pena leer a continuación varias secciones relacionadas:

Si necesitas editar o cambiar el estilo de fotos de producto existentes en lugar de generar desde cero, consulta flux-2-klein-4b para retoque de comercio electrónico con imagen a imagen: es una tarea distinta (i2i, no t2i), pensada para retocar fotos reales en lugar de generar nuevas escenas.
Para patrones de prompt propios del modo de imagen a imagen del nivel 9b (la misma potencia de renderizado de texto, aplicada a la edición), consulta prompts de imagen a imagen de flux-2-klein-9b.
Parámetros completos, precios en tiempo real y una consola para probar prompts antes de ejecutar lotes: página del modelo flux-2-klein-9b/text-to-image.

Preguntas frecuentes

¿flux-2-klein-9b/text-to-image admite imagen a imagen? No: este endpoint concreto solo admite texto a imagen. hiapi lista por separado un modelo flux-2-klein-9b/image-to-image (precio $0.03143/imagen) para editar fotos existentes.

¿Qué relaciones de aspecto se admiten? Cinco: 1:1, 4:3, 3:4, 16:9, 9:16. No hay 4:5 nativo: usa 3:4 para obtener un recorte vertical similar.

¿Puedo establecer la resolución de salida? No. Enviar el campo resolution devuelve un 400. El precio y el tamaño de salida son fijos según la relación de aspecto.

¿Sería más barato usar flux-2-klein-4b? Sí, es aproximadamente 6 veces más barato por imagen ($0.00143 frente a $0.00858), pero klein-4b no tiene la etiqueta de renderizado de texto. Úsalo para imágenes sin texto (escenas de estilo de vida puras o fondos) y reserva klein-9b para cualquier imagen con etiquetas, titulares o precios anotados.

¿Cuánto tarda la generación? Las tres imágenes de este artículo, mediante el flujo de consulta de /v1/tasks, se completaron en menos de dos minutos cada una.

Pruébalo

Puedes probar flux-2-klein-9b/text-to-image directamente en la página del modelo con tus propios prompts antes de conectarlo a tareas por lotes, y consultar las tarifas vigentes en cualquier momento en la página de precios. El esquema completo de solicitud/respuesta y la configuración de autenticación están en la documentación de la API.

Etiquetasecommerce Generación de imágenes Guía