Recraft

Recraft V4.1

recraft-v4.1/text-to-image

Modelo de generación de activos de diseño orientado a producción, compatible con salida vectorial SVG editable de forma nativa, genera imágenes estables con prompts breves, ideal para iconos, tipografía e ilustraciones de marca

recraft-v4.1-flash/text-to-image recraft-v4.1/text-to-image

Probar recraft-v4.1/text-to-image

Entrada

Colors

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

recraft-v4.1/text-to-image per image

Precio unitario	$0.050

Descripción general

Recraft V4.1 es un modelo de generación de recursos de diseño orientado a la producción, que tiende a entregar resultados listos para incorporarse directamente al flujo de diseño, en lugar de meras imágenes conceptuales para previsualización. Además de las imágenes de mapa de bits convencionales, destaca en tareas de iconos, tipografía e ilustración de marca; con prompts breves se obtiene una estética y composición bastante estables, y admite restringir la imagen mediante parámetros de color y color de fondo. Es adecuado para equipos de diseño y desarrolladores que necesitan producir materiales de marketing, ilustraciones de UI o gráficos vectoriales en lote, integrándose en flujos de automatización de contenido a través de la interfaz unificada de HiAPI.ai.

Puntos clave

Generación con enfoque de recurso de diseño: orientado a resultados finales y no a bocetos atmosféricos; las tareas de iconos, tipografía e ilustración alcanzan un mayor grado de acabado, lo que reduce el retrabajo posterior.
Estilo estable incluso con prompts breves: una descripción corta basta para obtener una dirección estética y de composición bastante precisa, lo que reduce el costo de ajuste de los prompts.
Color y fondo restringibles por parámetros: mediante una paleta RGB y el parámetro de color de fondo se limita la gama cromática de la imagen, lo que facilita ajustarse a los colores de marca y mantener una identidad visual uniforme.
Seis preajustes de formato que cubren las maquetas habituales: hay varias proporciones cuadradas, verticales y horizontales; con una sola llamada se cubren necesidades de formato para redes sociales, web e impresión.

Descripción de capacidades

Texto a imagen: basta con introducir una descripción de texto de hasta diez mil caracteres para generar imágenes, aplicable a estilos realistas, ilustración, renderizado 3D y degradados, entre otros; ideal para convertir directamente descripciones creativas en recursos utilizables.

Control del color de marca: admite pasar un conjunto de colores RGB como paleta preferida y especificar por separado el color de fondo, fijando en el resultado los colores de marca o la normativa visual de una serie, lo que reduce el costo de ajuste cromático imagen por imagen.

Selección de preajustes de formato: ofrece seis preajustes de tamaño: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3 y landscape_16_9; se elige la proporción según el canal de publicación y se evita el recorte posterior.

Generación por lotes vía API: al invocarse a través de la interfaz unificada de HiAPI.ai, la capacidad de generación puede integrarse en herramientas propias y flujos de procesamiento por lotes; el cobro es por imagen, adecuado para necesidades de generación automatizada con gran volumen de contenido.

Casos de uso

Generación masiva de materiales de marketing para equipos de marca: con el tema de la campaña y los colores de marca como entrada, se producen en lote anuncios e imágenes para redes sociales con estilo coherente, listos para publicación y planificación de contenido.
Creación de ilustraciones de interfaz para diseñadores UI/UX: con descripciones breves y un formato definido se generan imágenes e ilustraciones de interfaz, recursos visuales que pueden incorporarse a páginas de producto y borradores de diseño.
Ilustración automatizada para sistemas de contenido: el programa compone prompts según el tema del artículo y llama a la interfaz para producir ilustraciones de forma estable para la plataforma de contenido, reduciendo la búsqueda y edición manual de imágenes.
Exploración conceptual y pruebas de estilo: con varios prompts breves se prueban rápidamente imágenes atmosféricas y direcciones de estilo como referencia visual en la fase de propuesta, antes de decidir la vía de creación definitiva.

Limitaciones y recomendaciones de selección

Su enfoque se orienta a recursos de diseño y exploración conceptual, y no cubre todas las necesidades de generación de imágenes; en resultados con tipografía y gráficos detallados se recomienda una revisión humana antes de la entrega formal. Los parámetros solo admiten prompt, paleta de colores, color de fondo y preajustes de formato; no admite edición con máscaras, imágenes de referencia ni repintado local. Si la necesidad es fotografía realista con alto grado de libertad o edición compleja de múltiples rondas, conviene evaluar otros modelos más centrados en la generación y edición generales; si el proyecto ya está estandarizado sobre versiones anteriores, también puede mantenerse la versión existente para reducir el costo de cambio.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo disponible: recraft-v4.1-flash/text-to-image Nov 3, 2026
Nuevo modelo Nueva documentación de texto a imagen de recraft-v4.1-flash/text-to-image Oct 16, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Cuál es la diferencia entre Recraft V4.1 y V4.1 Flash?

V4.1 pone más énfasis en el detalle y el acabado, mientras que Flash es más rápido y adecuado para pruebas por lotes.
¿Qué tamaños son compatibles?

image_size admite seis valores: square_hd (predeterminado), square, portrait_4_3, portrait_16_9, landscape_4_3 y landscape_16_9.
¿Cómo se especifican los colores?

Mediante la API, pasa colors (un arreglo de objetos RGB) y background_color (un único objeto RGB); cada canal tiene un valor de 0 a 255. El Playground en línea no ofrece estos dos parámetros por ahora.
¿Se respetarán estrictamente los parámetros de combinación de colores?

colors es la paleta de colores preferida; la imagen intentará mantenerse dentro de este conjunto de colores; si el prompt incluye colores claramente conflictivos, el resultado podría mezclar ambos.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: recraft-v4.1/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para recraft-v4.1/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.

colorsarrayOpcional

Especifica la paleta de colores preferida, pasada como un array de objetos RGB, donde cada canal tiene un valor entre 0 y 255; la estructura de los elementos del array se define mediante los campos b/g/r.

Array [ object ]

Elementos del array

bintegerObligatoriomin 0max 255

Valor del canal azul de un color individual de la paleta, entero, con valor de 0 a 255.

gintegerObligatoriomin 0max 255

Valor del canal verde de un color individual de la paleta, entero, con valor de 0 a 255.

rintegerObligatoriomin 0max 255

Valor del canal rojo de un color individual de la paleta, entero, con valor de 0 a 255.

promptstringObligatoriominLength 1maxLength 10000

Descripción textual de la imagen que se va a generar, como una cadena de texto sin formato.

image_sizestringOpcionalPredeterminado: "square_hd"

Preajuste del tamaño de la imagen de salida, cadena; por defecto square_hd.

Opciones:square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

background_colorobjectOpcional

Color de fondo preferido, pasado como un objeto RGB, donde cada canal tiene un valor entre 0 y 255; los canales concretos se definen mediante los campos b/g/r.

bintegerObligatoriomin 0max 255

Valor del canal azul del color de fondo, entero, con valor de 0 a 255.

gintegerObligatoriomin 0max 255

Valor del canal verde del color de fondo, entero, con valor de 0 a 255.

rintegerObligatoriomin 0max 255

Valor del canal rojo del color de fondo, entero, con valor de 0 a 255.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft-v4.1/text-to-image",
  "input": {
    "prompt": "…",
    "image_size": "square_hd"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "recraft-v4.1/text-to-image",
    input: {
      "prompt": "…",
      "image_size": "square_hd"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "recraft-v4.1/text-to-image",
        "input": {
          "prompt": "…",
          "image_size": "square_hd"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}