Skip to main content
Krea 3 es un modelo rápido de edición de imágenes. Sigue instrucciones en lenguaje natural: tú indicas qué debe cambiar y qué debe permanecer igual, y Krea 3 genera la edición en segundos. También puedes usarlo para generar imágenes a partir de texto.
La API de Krea 3 está en acceso anticipado. Solo los workspaces incluidos en la beta de Krea 3 pueden llamarla. Para solicitar acceso, escribe a sales@krea.ai.

Endpoint

El endpoint sigue el ciclo de vida de un job estándar: devuelve un job_id y haces polling a GET /jobs/{job_id} (o usas un webhook) hasta que el job se complete. La imagen resultante está en result.urls[0].

Inicio rápido: tu primera edición de imagen

Todas las solicitudes requieren un token Bearer. Consulta Claves de API y facturación si aún no tienes uno.
1

Sube una referencia

Envía POST /assets con tu imagen de entrada. La respuesta devuelve image_url. También puedes pasar directamente en image_urls una URL de imagen externa o un data URI en base64.
2

Crea una edición

Envía POST /generate/image/krea/krea-3 con tu prompt y tu referencia. Guarda el job_id de la respuesta.
3

Obtén el resultado

Haz polling a GET /jobs/{job_id} hasta que status sea completed. El resultado está en result.urls[0].
Mantén tu token de API en tu servidor. Nunca lo incluyas en código del lado del cliente.

Parámetros

Con width y height, el resultado se redondea a la relación de aspecto compatible más cercana y a un lienzo de 1k o 2k. No se garantizan dimensiones exactas en píxeles.Reutilizar una seed no garantiza resultados idénticos, porque el paso de expansión del prompt puede variar entre ejecuciones.

Modos de razonamiento

Antes de generar, Krea 3 interpreta tu prompt. thinking_mode define cuánta planificación realiza. Si omites thinking_mode, la API usa fast. Ambos modos admiten regional_edit.

Ediciones regionales

Con regional_edit: true, Krea 3 regenera solo las partes de la imagen que necesitan cambiar. Todo lo demás se mantiene exactamente igual, así que puedes editar la misma imagen una y otra vez sin perder calidad. Úsalo para ediciones locales en las que el resto de la imagen debe mantenerse idéntico píxel a píxel: cambiar el color de un objeto o sustituirlo, añadir o quitar un elemento, corregir un detalle o cambiar el texto de un cartel. Es la forma segura de encadenar ediciones sobre el último resultado. No lo uses para ediciones globales que deban volver a renderizar toda la imagen: cambiar el estilo o la iluminación, cambiar la estación o la hora del día, reencuadrar o combinar varias imágenes en una escena nueva. Las ediciones normales vuelven a renderizar toda la imagen, por lo que pueden acumularse artefactos si sigues editando el último resultado. Las ediciones regionales requieren al menos una imagen en image_urls.

Prompts

Krea 3 es un editor que sigue instrucciones. Escribe la edición en lenguaje natural:
  • Empieza por el cambio. Añade solo los detalles que ayuden a ejecutarlo.
  • Termina con una frase de preservación cuando el resto de la imagen deba permanecer igual. No enumeres todo lo que debe mantenerse.
  • Cuando el prompt use más de una imagen, refiérete a cada una por lo que muestra. Por ejemplo: “Pon la zapatilla de la segunda imagen a la persona de la primera imagen.”

Referencias de imagen

  • Krea 3 usa cada referencia con la resolución con la que se subió. Una referencia de más de 4 MP se redimensiona a 4 MP.
  • Alrededor de 1 MP es suficiente para la mayoría de las ediciones. No escales una referencia antes de enviarla.
  • Cuando los detalles finos importan (texto pequeño, logotipos, tejidos, caras en un plano general), envía la versión de mayor resolución de la imagen que tengas.
  • Con cinco o más referencias en una solicitud, cada referencia se redimensiona a un máximo de 1536 px en su lado más largo. Para referencias con todo su detalle, envía cuatro o menos.

Zero Data Retention

Krea 3 admite Zero Data Retention para workspaces enterprise. Envía el header X-Api-Zero-Data-Retention: 1. Con Zero Data Retention:
  • Cada imagen en image_urls debe ser un data URI en base64.
  • thinking_mode puede ser fast o high.
  • Una solicitud puede usar como máximo 4 referencias de imagen.

Precios

El precio por imagen depende de la resolución de salida, del modo de razonamiento y de las referencias de imagen.

Relacionado

Ciclo de vida de un job

Estados de los jobs, polling y resultados.

Webhooks

Recibe una notificación cuando un job se complete en lugar de hacer polling.