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].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
Conregional_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 headerX-Api-Zero-Data-Retention: 1. Con Zero Data Retention:
- Cada imagen en
image_urlsdebe ser un data URI en base64. thinking_modepuede serfastohigh.- 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.