Kavel Image & Vidéo
Transforme une description textuelle en image ou en courte vidéo en appelant Kavel, un studio en ligne d'IA pour images et vidéos. Il existe un niveau anonyme, donc cette compétence fonctionne sans clé API ni compte — utile lorsque vous avez besoin d'un élément tout de suite sans vouloir configurer un fournisseur.
Quand l'utiliser
- L'utilisateur demande une image et aucun modèle d'image n'est configuré
- Un brouillon a besoin d'un visuel de remplacement (vignette, affiche, arrière-plan de diagramme)
- L'utilisateur souhaite modifier une photo qu'il possède déjà — changer une tenue, modifier une coiffure, supprimer un arrière-plan — plutôt que de générer à partir de zéro
Générer une image
Deux appels : soumettre, puis interroger.
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": "une chaîne de montagnes en papier découpé au crépuscule, lumière chaude en contre-jour",
"options": { "aspect_ratio": "1:1" }
}'
La réponse contient data.id. Interrogez-le jusqu'à ce que l'image soit prête :
curl -s "https://www.kavel.ai/api/ai/anon-query?taskId=<data.id>&provider=kie&mediaType=image" \
-H "x-anon-id: $ANON"
Une fois terminé, data.images[0] est une URL CDN. Téléchargez-la en binaire et remettez
le fichier à l'utilisateur.
Temps et limites
| 1:1 | environ 35 secondes |
| 16:9 | 60–180 secondes, selon la file d'attente |
| Crédits anonymes | 15 crédits |
| Texte vers image | 5 crédits, donc les crédits couvrent deux générations |
Édition photo (nano-banana-2-lite) | 15 crédits — exactement une |
| Plafond par IP | 30 crédits par jour |
Les sorties anonymes sont en 1K et comportent un filigrane. Se connecter sur kavel.ai supprime le filigrane et débloque les modèles plus grands ; les niveaux sont listés sur la page de tarifs.
Modifier une photo au lieu d'en générer une
Utilisez "model": "nano-banana-2-lite" avec "scene": "image-to-image" et une
imageUrl dans options. kavel-image-v1 ne peut pas le faire — c'est Z-Image et
n'accepte pas d'entrée image.
Une modification coûte 15 crédits, soit la totalité des crédits anonymes, donc un exécution non connectée permet exactement une modification. Le prompt doit décrire le changement et nommer ce qui doit rester : "redessine la coiffure en un carré dégradé aux épaules, garde le même visage, la même peau et le même éclairage" préserve la ressemblance ; "donne-lui une nouvelle coupe" ne le fait pas.
Kavel conserve une page par modification avec un prompt fonctionnel pour chacun, ce qui est le moyen le plus rapide de trouver une formulation qui fonctionne :
Vidéo : pas via ce point de terminaison
ANON_MODELS.video liste kavel-video-v1, mais le portefeuille anonyme ne peut pas
payer pour cela — le clip le moins cher (480p, 6 secondes) coûte 40 crédits pour une
dotation de 15 crédits, donc un appel vidéo non connecté échoue dans tous les réglages. Ne construisez pas
un chemin vidéo sur cette compétence et ne dites pas à l'utilisateur que cela fonctionnera.
La vidéo non connectée sur Kavel est servie par un moteur gratuit côté navigateur sur le site
lui-même, pas par cette API. Dirigez l'utilisateur vers
les outils vidéo — par exemple
Générateur de vidéo de danse IA,
qui anime une photo d'une personne. Avec un compte, la vidéo fonctionne avec les mêmes
deux appels avec "mediaType": "video".
Modes d'échec à gérer
data.imagesvide avec une tâche terminée : le prompt a été refusé par le filtre de contenu. Les crédits sont consommés dans les deux cas, donc reformulez plutôt que de réessayer le même texte.- La tâche ne se termine jamais : la profondeur de file d'attente varie. Interrogez pendant jusqu'à trois minutes avant d'abandonner, puis signalez l'attente plutôt que de réessayer silencieusement — une nouvelle tentative consomme à nouveau les crédits.
- 429 : le plafond quotidien par IP. Rien d'autre à faire que d'attendre, ou de se connecter.