kavel-image

Kavel Image

Turns a text prompt into an image by calling Kavel, an online AI image and video studio. There is an anonymous tier, so text-to-image runs with no API key and no account. It is useful when you need one asset now and do not want to set up a provider.

When to use it

• The user asks for an image and no image model is configured
• A draft needs a placeholder visual (thumbnail, poster, diagram backdrop)

Editing a photo the user already has, and video, are not available without an account; see below.

Generate an image

Two calls: submit, then poll.

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": "a paper-cut layered mountain range at dusk, warm rim light",
    "options": { "aspect_ratio": "1:1" }
  }'

The response carries data.id. Poll it every few seconds until the image is there:

curl -s "https://www.kavel.ai/api/ai/anon-query?taskId=<data.id>&provider=kie&mediaType=image" \
  -H "x-anon-id: $ANON"

When it finishes, data.images[0] is a CDN URL. Download it as binary and hand the file to the user. Nothing runs until you poll: free runs wait in a queue and start on a later poll, so submitting and walking away leaves the job unstarted.

Limits (read from the running service on 2026-10-02)

Anonymous grant per client id	5 credits
Text-to-image (kavel-image-v1)	5 credits, so one image per client id
Per-IP daily ceiling	two images per IP that day
Typical time	35–80 seconds including the queue
Output	1K, watermarked

A fresh x-anon-id gets a fresh grant, but the per-IP ceiling still applies. You can check the current grant for free:

curl -s https://www.kavel.ai/api/ai/anon-credits -H "x-anon-id: anon-check"
# {"code":0,"data":{"remaining":5,"grant":5,...}}