Audiovisual & IAkrea ai
Krea AI API: claves, costes y primera imagen
Krea AI API permite generar imágenes y vídeo desde un flujo propio. Aprende a crear una clave, enviar una primera petición y calcular el coste por generación.
- Autor: humAIns
- 10 min de lectura
índice · 6 apartados
Krea AI API permite conectar la generación de imágenes y vídeo con una aplicación o flujo de trabajo propio, en lugar de operar cada pieza manualmente en la interfaz. Para empezar se necesita un token, una petición HTTP al endpoint del modelo elegido y saldo API; la suscripción de la app no cubre ese consumo. En esta guía verás una llamada de ejemplo, cómo vigilar los trabajos y cómo estimar costes sin confundir una tarifa base con el total de un encargo.
La guía de Krea AI y su interfaz explica Realtime y Enhancer. Aquí el foco es distinto: integración programática, autenticación, facturación y controles para un lote creativo.
Qué permite la API y cuándo compensa frente a la interfaz
La API REST de Krea expone modelos de imagen y vídeo. En el equipo audiovisual puede servir, por ejemplo, para que una persona técnica convierta una hoja aprobada de prompts en una cola de propuestas visuales, guarde los identificadores de trabajo y devuelva los resultados a una carpeta de revisión. La dirección de arte define el encuadre, el tratamiento, las restricciones y los criterios de selección; la integración automatiza la repetición, no sustituye ese criterio.
La interfaz suele ser más práctica para explorar una idea, ajustar un prompt a mano o evaluar herramientas. Una API empieza a tener sentido cuando se repiten pasos y quieres conectarlos con un sistema propio, controlar entradas y salidas o ejecutar lotes con trazabilidad. Antes de automatizar, verifica que el modelo y los parámetros de la referencia oficial cubren tu caso: el catálogo y los endpoints cambian.
Un ejemplo de prueba seguro: generar variaciones de un bodegón ficticio, sin logotipos, nombres de cliente ni material confidencial. El equipo puede revisar composición y paleta, escoger una propuesta y llevarla a la herramienta creativa habitual para el acabado. No uses el lote como entrega automática: cada resultado puede contener errores y necesita aprobación.
Requisitos y primera petición a Krea API
Necesitas una cuenta y un workspace con acceso a API habilitado. La documentación indica que el token se crea desde la página de tokens de Krea. Hay tokens personales, que actúan con los permisos de tu cuenta, y tokens de servicio, que representan un usuario de servicio del workspace. Los propietarios y administradores pueden crear tokens de servicio y consultar el gasto por token; los personales dejan de funcionar si su titular abandona el workspace.
El siguiente ejemplo adapta el endpoint y el cuerpo de la introducción oficial para Krea 3. Define KREA_API_KEY en el entorno de ejecución; nunca sustituyas la variable por una clave real en un archivo que vayas a compartir. La petición puede generar gasto si el trabajo se completa.
curl -X POST https://api.krea.ai/generate/image/krea/krea-3 \
-H "Authorization: Bearer $KREA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Bodegón conceptual de una botella de vidrio ámbar sin etiqueta, luz suave, fondo verde salvia",
"aspect_ratio": "16:9",
"resolution": "1K",
"thinking_mode": "fast"
}'
La documentación muestra que la respuesta contiene un job_id; algunas operaciones son asíncronas, así que no presupongas que la imagen llega dentro de la respuesta inicial. Guarda el identificador y sigue el ciclo de trabajo descrito en Job Lifecycle o usa el SDK oficial si encaja con tu lenguaje. La guía de Krea 3 lista la ruta y los parámetros disponibles; vuelve a comprobarlos al implementar porque pueden actualizarse.
Comprueba el código HTTP y el cuerpo antes de procesar el resultado. No registres el token en logs ni devuelvas errores internos a usuarios finales. Valida que el estado haya terminado correctamente, que exista una URL de resultado y que el archivo se descargue en un destino controlado. Si se agota el saldo, Krea documenta un error HTTP 402 para nuevas peticiones; los trabajos que ya están en curso pueden finalizar.
Krea API: precio, saldo y cálculo de un lote
La API se cobra por generación y el precio depende del modelo y de los parámetros, como resolución, referencias o modo de calidad. El saldo de API es independiente de las unidades de cómputo de la aplicación: tener una suscripción Krea Pro o Max no significa que las llamadas API estén incluidas. La documentación de facturación afirma que los trabajos fallidos o cancelados no se facturan y que solo se cobra el trabajo completado.
En la página oficial de precios consultada para esta guía, Krea 3 aparece a 0,03 USD por imagen 1K y 0,06 USD por imagen 2K. Añadir referencias tiene un coste: cada referencia de hasta 1024 × 1024 añade 0,02 USD y las referencias mayores, 0,07 USD; la opción High thinking añade 0,02 USD según la tabla publicada. Son importes consultados el 17 de noviembre de 2026, no una oferta permanente; revisa la tarifa actual de Krea API antes de aprobar un presupuesto.
Ejemplo hipotético, con supuestos explícitos: un lote de 20 imágenes Krea 3 en 1K, sin referencias y con modo fast, costaría 20 × 0,03 = 0,60 USD si las 20 generaciones terminan correctamente. Si cada una llevara una referencia pequeña, serían 20 × (0,03 + 0,02) = 1 USD. No incluye impuestos, conversiones de moneda ni reintentos completados. Para vídeo no extrapoles el coste de imagen: consulta el precio del endpoint y la duración, resolución y opciones concretas de ese modelo.
La página de API indica que se puede añadir saldo desde 5 USD y que no hay cuota mensual ni tarifa por asiento; la documentación de pagos describe recarga prepago y un área de uso para consultar trabajos completados y costes estimados. Comprueba las condiciones actuales en la cuenta: los precios y mecanismos comerciales pueden cambiar.
| Concepto | Qué revisar antes de lanzar |
|---|---|
| Plan de la aplicación | No equivale al saldo para llamadas API |
| Modelo y endpoint | Parámetros admitidos y precio unitario vigente |
| Extras | Resolución, referencias, modo de calidad y duración |
| Estado del trabajo | Solo presupuestar como consumo los trabajos completados según la política publicada |
| Saldo y uso | Panel API de Krea; no des por disponible una consulta programática del saldo |
Integración en producción: estados, resultados y errores
Trata cada generación como un trabajo con un identificador y estados, no como una respuesta instantánea garantizada. Persiste el identificador, la solicitud relevante (sin secretos ni datos innecesarios), el modelo y el momento de envío. Usa el mecanismo documentado para seguir su estado —consulta de trabajo o webhooks, según el flujo elegido— y define qué hacer si falla, tarda más de lo esperado o no entrega una URL utilizable.
No repitas una solicitud automáticamente ante cualquier timeout: si el servidor completó el trabajo pero la respuesta se perdió, un reintento podría crear otra generación facturable. Diseña una política de reintentos limitada, con registro de cada intento y revisión del estado previo cuando sea posible. Respeta los límites publicados por Krea y aplica una cola con concurrencia controlada; no asumas cuotas ilimitadas.
Separa el prototipo de producción. En una prueba manual, una persona comprueba prompt, resultado y consumo. En producción, añade límites por lote, alertas internas de saldo, validación de tipos de archivo, control de acceso y una ruta de cancelación. El área de uso de Krea permite revisar trabajos y costes estimados; la documentación señala que el saldo no tiene un endpoint público de consulta, así que evita basar la operación en una integración no documentada.
Para imagen y vídeo, los parámetros y las respuestas no son intercambiables. Consulta las referencias oficiales para generación de imagen Krea 3, generación de vídeo y errores y depuración. No afirmes que cada modelo esté disponible en todas las cuentas ni uses un endpoint copiado de un tutorial antiguo sin contrastarlo con la referencia actual.
Seguridad, privacidad y derechos del material
Una API key es una credencial con capacidad de gasto y acceso. Guárdala como variable de entorno o en un gestor de secretos, crea claves distintas para desarrollo y producción, limita quién puede leerlas y revócalas inmediatamente si se filtran. No la incluyas en una app de navegador, en código descargable, capturas, tickets o repositorios. Para un flujo de equipo, valora un token de servicio con permisos adecuados y titularidad clara.
No envíes fotografías de personas, guiones bajo embargo, diseños inéditos ni otros recursos de cliente sin autorización y una base contractual válida. Antes de integrarlo, revisa los términos de Krea, las condiciones del workspace y las obligaciones acordadas con el cliente. Verifica también qué datos se envían, quién puede acceder a los resultados y cuánto tiempo se conservan. La licencia de la plataforma no resuelve por sí sola derechos de autor, imagen o marca sobre los materiales de entrada o salida.
La decisión de qué imagen representa al proyecto sigue siendo del equipo. Para practicar ese criterio con herramientas y tareas reales, consulta el artículo de IA para dirección de arte y el pilar de IA para cine y producción audiovisual. Si buscas una introducción a Krea desde la interfaz, vuelve a la guía de Krea AI.
Preguntas frecuentes sobre Krea API
¿La API está incluida en la suscripción de la app?
No. La suscripción de la aplicación y el saldo API se facturan por separado, según la documentación de Krea. Las solicitudes directas con token usan el saldo API; confirma el detalle vigente en la página de facturación.
¿Cómo creo y protejo una Krea API key?
En la página de tokens, crea una clave personal o una de servicio si tienes rol de propietario o administrador. Ponle un nombre reconocible y guárdala en un gestor de secretos o variable de entorno: Krea indica que solo se muestra una vez. No la subas al repositorio y revócala si se compromete.
¿Puedo generar imágenes y vídeo?
La plataforma documenta endpoints de ambos tipos, pero cada modelo tiene una ruta, parámetros y precio específicos. Revisa la referencia del endpoint elegido y confirma acceso en tu workspace antes de desarrollar una integración.
¿Cómo calculo el coste de un lote?
Usa la tarifa por generación para el modelo y parámetros elegidos, multiplícala por el número estimado de trabajos completados y añade referencias u otros extras. Como ejemplo de tarifa observada, 20 imágenes Krea 3 1K sin extras suman 0,60 USD; valida la tarifa vigente y deja margen para pruebas antes de fijar un presupuesto.
El curso de IA audiovisual trabaja criterio creativo y flujos audiovisuales; no es un curso de programación ni promete enseñar una integración API. Para identificar qué habilidades te conviene reforzar, completa el test ¿Cuánto te queda?.
Sigue leyendo en humAIns