Imagem e Vídeo Kavel
Transforma um prompt de texto em uma imagem ou vídeo curto chamando Kavel, um estúdio online de imagens e vídeos por IA. Há um nível anônimo, então esta habilidade funciona sem chave de API e sem conta — útil quando você precisa de um ativo agora e não quer configurar um provedor.
Quando usar
- O usuário pede uma imagem e nenhum modelo de imagem está configurado
- Um rascunho precisa de uma imagem de espaço reservado (miniatura, pôster, fundo de diagrama)
- O usuário deseja editar uma foto que já possui — trocar uma roupa, mudar um penteado, remover um fundo — em vez de gerar do zero
Gerar uma imagem
Duas chamadas: enviar, depois consultar.
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": "uma cordilheira em camadas de papel recortado ao entardecer, luz quente de contorno",
"options": { "aspect_ratio": "1:1" }
}'
A resposta traz data.id. Consulte até a imagem estar disponível:
curl -s "https://www.kavel.ai/api/ai/anon-query?taskId=<data.id>&provider=kie&mediaType=image" \
-H "x-anon-id: $ANON"
Quando terminar, data.images[0] é uma URL de CDN. Baixe como binário e entregue
o arquivo ao usuário.
Tempo e limites
| 1:1 | cerca de 35 segundos |
| 16:9 | 60–180 segundos, dependendo da fila |
| Concessão anônima | 15 créditos |
| Texto para imagem | 5 créditos, então a concessão cobre duas |
Edição de foto (nano-banana-2-lite) | 15 créditos — exatamente uma |
| Limite por IP | 30 créditos por dia |
A saída anônima é 1K e possui marca d'água. Fazer login em kavel.ai remove a marca d'água e libera os modelos maiores; os níveis estão listados na página de preços.
Editando uma foto em vez de gerar uma
Use "model": "nano-banana-2-lite" com "scene": "image-to-image" e uma
imageUrl em options. kavel-image-v1 não consegue fazer isso — é Z-Image e
não aceita entrada de imagem.
Uma edição custa 15 créditos, que é toda a concessão anônima, então uma execução sem login obtém exatamente uma. O prompt deve descrever a mudança e nomear o que deve permanecer: "mude o penteado para um corte em camadas na altura dos ombros, mantenha o mesmo rosto, pele e iluminação" preserva a semelhança; "dê a ela um novo corte de cabelo" não.
O Kavel mantém uma página por edição com um prompt funcional em cada uma, que é a forma mais rápida de encontrar uma redação que funcione:
Vídeo: não por este endpoint
ANON_MODELS.video lista kavel-video-v1, mas a carteira anônima não consegue
pagar por ele — o clipe mais barato (480p, 6 segundos) custa 40 créditos contra uma
concessão de 15 créditos, então uma chamada de vídeo sem login falha em qualquer
configuração. Não construa um caminho de vídeo nesta habilidade e não diga ao
usuário que funcionará.
O vídeo sem login no Kavel é servido por um mecanismo gratuito do lado do navegador
no próprio site, não por esta API. Aponte o usuário para
as ferramentas de vídeo — por exemplo
Gerador de Vídeo de Dança com IA,
que anima uma foto de uma pessoa. Com uma conta, o vídeo funciona através das mesmas
duas chamadas com "mediaType": "video".
Modos de falha que vale a pena tratar
data.imagesvazio com uma tarefa concluída: o prompt foi recusado pelo filtro de conteúdo. Os créditos são consumidos de qualquer forma, então reescreva em vez de repetir o mesmo texto.- A tarefa nunca termina: a profundidade da fila varia. Consulte por até três minutos antes de desistir, então relate a espera em vez de tentar novamente em silêncio — uma nova tentativa gasta os créditos novamente.
- 429: o limite diário por IP. Não há nada a fazer a não ser esperar, ou fazer login.