Krea

Krea 2 Medium Turbo

krea-2-medium-turbo

Versión de destilación acelerada de la serie Krea 2, prioriza la velocidad, con bajo coste por imagen, ideal para iteraciones rápidas y exploración de conceptos de diseño

krea-2-medium-turbo

Probar krea-2-medium-turbo

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

krea-2-medium-turbo per image

Precio unitario	$0.0215

Descripción general

krea-2-medium-turbo es un modelo de generación de imágenes a partir de texto de Krea orientado a la producción rápida de imágenes, que emplea un proceso de muestreo acelerado por destilación para reducir el coste de generación por imagen sin perder la expresividad del sistema de estilo Krea 2. Está pensado para desarrolladores de diseño y creatividad que necesitan iterar con alta frecuencia y desplegar rápidamente distintas direcciones visuales; genera imágenes mediante indicaciones en lenguaje natural a través de la interfaz unificada de HiAPI.ai y permite controlar el resultado con la relación de aspecto, el nivel de creatividad y la semilla aleatoria.

Puntos clave

Generación acelerada orientada a la iteración frecuente: el proceso de muestreo por destilación reduce el tiempo de generación por imagen y facilita probar varias direcciones de indicación de forma consecutiva en poco tiempo.
Libertad creativa ajustable por niveles: creativity ofrece cuatro niveles, de raw a high, desde el ajuste estricto a la indicación hasta la interpretación libre, lo que facilita equilibrar control y exploración.
Composición predefinida según el canal: admite ocho relaciones de aspecto como 1:1, 16:9, 2.35:1 y 9:16, que encajan directamente con los formatos y ubicaciones de publicación.
Resultados reproducibles: al especificar seed, la misma indicación y semilla reproducen la misma imagen, lo que facilita las pruebas de regresión y la comparación entre versiones.

Capacidades

Generación de imágenes a partir de texto en lenguaje natural: describe la escena con una indicación de hasta 5000 caracteres y el modelo genera la imagen directamente, lo que resulta adecuado para convertir rápidamente descripciones creativas en material visual utilizable.

Control del nivel de creatividad: creativity es low por defecto y permite elegir raw, medium o high, alternando según sea necesario entre el seguimiento estricto de la indicación y la interpretación libre.

Control de relación de aspecto y semilla: aspect_ratio abarca desde proporciones cuadradas hasta ultraanchas y verticales, y junto con seed fija el resultado, lo que facilita la generación por lotes y la verificación repetida.

Cobertura visual estilizada: continúa el sistema de estilo Krea 2 y ofrece un amplio margen de expresión en ilustración, estilos gráficos y direcciones conceptuales.

Casos de uso

Despliegue rápido de direcciones visuales por parte de diseñadores: introduce indicaciones de estilo y temática y genera por lotes borradores con distintas composiciones para filtrar direcciones en las primeras fases del proyecto.
Bocetos conceptuales para campañas de marketing: genera varias imágenes conceptuales a partir de la temática de la campaña y la proporción del formato, para propuestas internas y debates de dirección.
Exploración de estilos de ilustración y gráficos: prueba lenguajes visuales de ilustración y estilo gráfico con indicaciones descriptivas y produce muestras de estilo que pueden incorporarse directamente a la biblioteca de recursos.
Funciones de generación de imágenes inmediata dentro de aplicaciones: integra la generación de imágenes a partir de texto en herramientas creativas o aplicaciones de contenido para devolver resultados de imagen al instante según la indicación del usuario.

Limitaciones y recomendaciones de selección

Este modelo es una versión destilada priorizada para la velocidad, más adecuada para la iteración rápida y la exploración conceptual; no se recomienda como opción predeterminada para versiones finales de alta fidelidad. Solo admite generación de imágenes a partir de texto y no abarca vídeo ni edición de imágenes. Si el flujo de trabajo requiere una coherencia de estilo más estable y detalles de calidad final, puede considerarse la versión no Turbo de la misma serie; en escenarios con altos requisitos de resolución debe verificarse primero si la salida los cumple.

Novedades

Ver el registro de cambios →

Nuevo modelo Nueva documentación de texto a imagen de krea-2-medium-turbo Oct 17, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué es adecuado Krea 2 Medium Turbo?

Genera imágenes de alta fidelidad rápidamente a partir de una descripción de texto, por lo que es adecuado para escenarios que requieren generar imágenes con rapidez y ajustar los prompts repetidamente, como bocetos conceptuales, imágenes para redes sociales y escenas con estilo cinematográfico.
¿Qué relaciones de aspecto se admiten?

aspect_ratio admite 1:1 (predeterminado), 4:3, 3:2, 16:9, 2.35:1, 4:5, 2:3 y 9:16, en total 8 opciones.
¿Para qué tipo de imágenes es adecuada la relación 2.35:1?

2.35:1 es una relación de aspecto cinematográfica panorámica común, adecuada para composiciones ultra anchas como escenas con sensación cinematográfica, banners de sitios web y portadas de vídeo.
¿Qué función tiene creativity (nivel de creatividad)?

creativity controla el grado de libertad del modelo al interpretar el prompt; los valores disponibles son raw, low, medium y high. Cuanto más bajo es el nivel, más se ciñe a la descripción; cuanto más alto, más creativa es la imagen, aunque también puede desviarse de la descripción.

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: krea-2-medium-turbo

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para krea-2-medium-turbo y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcional

Semilla aleatoria opcional. La misma semilla y el mismo prompt permiten reproducir la misma imagen; si no se proporciona, el servidor la genera de forma aleatoria.

promptstringObligatoriominLength 1maxLength 5000

Descripción textual de la imagen que se va a generar, utilizada para indicar al modelo qué contenido debe dibujar.

creativitystringOpcionalPredeterminado: "low"

Controla el grado de libertad con el que el modelo interpreta el prompt: cuanto más se incline hacia lo literal, más seguirá estrictamente el prompt; cuanto más se incline hacia lo creativo, mayor será el margen de interpretación. Valor predeterminado: low.

Opciones:rawlowmediumhigh

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de la imagen de salida. Valor predeterminado: 1:1.

Opciones:1:14:33:216:92.35:14:52:39:16

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": "krea-2-medium-turbo",
  "input": {
    "prompt": "…",
    "creativity": "low",
    "aspect_ratio": "1:1"
  }
}'

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: "krea-2-medium-turbo",
    input: {
      "prompt": "…",
      "creativity": "low",
      "aspect_ratio": "1:1"
    }
  }),
});
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": "krea-2-medium-turbo",
        "input": {
          "prompt": "…",
          "creativity": "low",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}