Kavel Imagen y Video
Convierte un texto en una imagen o un video corto llamando a Kavel, un estudio de imagen y video con IA en línea. Hay un nivel anónimo, por lo que esta habilidad funciona sin clave API y sin cuenta — útil cuando necesitas un activo ahora mismo y no quieres configurar un proveedor.
Cuándo usarlo
- El usuario pide una imagen y no hay ningún modelo de imagen configurado
- Un borrador necesita un visual provisional (miniatura, póster, fondo de diagrama)
- El usuario quiere editar una foto que ya tiene — cambiar una prenda, modificar un peinado, eliminar un fondo — en lugar de generar desde cero
Generar una imagen
Dos llamadas: enviar y luego sondear.
ANON="anon-$(uuidgen | tr 'A-Z' 'a-z')"
curl -s -X POST https://www.kavel.ai/api/ai/generate \
-H "Content-Type: application/json" \
-H "x-anon-id: $ANON" \
-d '{
"provider": "kie",
"mediaType": "image",
"model": "kavel-image-v1",
"scene": "text-to-image",
"prompt": "un paisaje de montañas en capas de papel recortado al atardecer, cálida luz de contorno",
"options": { "aspect_ratio": "1:1" }
}'
La respuesta incluye data.id. Sondea hasta que la imagen esté lista:
curl -s "https://www.kavel.ai/api/ai/anon-query?taskId=<data.id>&provider=kie&mediaType=image" \
-H "x-anon-id: $ANON"
Cuando termine, data.images[0] será una URL de CDN. Descárgala como binario y entrega
el archivo al usuario.
Tiempos y límites
| 1:1 | alrededor de 35 segundos |
| 16:9 | 60–180 segundos, dependiendo de la cola |
| Crédito anónimo | 15 créditos |
| Texto a imagen | 5 créditos, por lo que el crédito cubre dos |
Edición de foto (nano-banana-2-lite) | 15 créditos — exactamente una |
| Límite por IP | 30 créditos al día |
La salida anónima es de 1K y lleva una marca de agua. Iniciar sesión en kavel.ai elimina la marca de agua y abre los modelos más grandes; los niveles se listan en la página de precios.
Editar una foto en lugar de generar una nueva
Usa "model": "nano-banana-2-lite" con "scene": "image-to-image" y una
imageUrl en options. kavel-image-v1 no puede hacer esto — es Z-Image y no
acepta entrada de imagen.
Una edición cuesta 15 créditos, que es todo el crédito anónimo, por lo que una sesión sin inicio de sesión obtiene exactamente una. El prompt debe describir el cambio y nombrar lo que debe permanecer: "cambiar el peinado a un corte en capas a la altura de los hombros, mantener la misma cara, piel e iluminación" conserva el parecido; "darle un nuevo corte de pelo" no lo hace.
Kavel mantiene una página por edición con un prompt funcional en cada una, que es la forma más rápida de encontrar frases que funcionen:
Video: no a través de este endpoint
ANON_MODELS.video lista kavel-video-v1, pero la cartera anónima no puede pagar
por él — el clip más barato (480p, 6 segundos) cuesta 40 créditos frente a un crédito
de 15, por lo que una llamada de video sin inicio de sesión falla en cualquier
configuración. No construyas una ruta de video con esta habilidad y no le digas al
usuario que funcionará.
El video sin inicio de sesión en Kavel se sirve mediante un motor gratuito del lado del navegador en el propio sitio,
no por esta API. Redirige al usuario a
las herramientas de video — por ejemplo
Generador de videos de baile con IA,
que anima una foto de una persona. Con una cuenta, el video funciona con las mismas
dos llamadas usando "mediaType": "video".
Modos de fallo que vale la pena manejar
data.imagesvacío con una tarea terminada: el prompt fue rechazado por el filtro de contenido. Los créditos se consumen de todas formas, así que reescribe en lugar de reintentar el mismo texto.- La tarea nunca termina: la profundidad de la cola varía. Sondea hasta tres minutos antes de rendirte, luego informa la espera en lugar de reintentar en silencio — un reintento gasta los créditos de nuevo.
- 429: el límite diario por IP. No hay nada que hacer más que esperar, o iniciar sesión.