kavel

Generate images from a prompt with no API key and no account.

from kavel import generate

url = generate("a paper-cut layered mountain range at dusk, warm rim light")

That is the whole setup. No key to fetch, no config file, no dependencies — standard library only. It calls the anonymous endpoint on Kavel, an online AI image and video studio.

Editing a photo

Pass image_url and the prompt describes the change rather than the picture:

url = generate(
    "restyle the hair into a shoulder-length layered cut, "
    "keep the same face, skin and lighting",
    image_url="https://example.com/portrait.jpg",
)

Naming what must stay is what holds the likeness. Prompts that only name the edit tend to drift the whole face.

What the free tier actually covers

Anonymous output is 1K and watermarked. Signing in on kavel.ai removes the watermark and opens the larger models.

Video is deliberately not exposed here. The cheapest clip is 40 credits against a 15-credit anonymous wallet, so a signed-out call cannot succeed at any setting. Signed-out video on the site runs on a browser-side engine instead — see the video tools.

Errors worth catching

Each failure is its own subclass of KavelError, so you can branch on what to do next:

• QuotaError — the free allowance (or, with a key, your account's credits) is spent
• RejectedError — the content filter refused the prompt; rewrite it rather than retrying
• SignInError — the request needs an account or a plan that includes that model
• AuthError — the API key is wrong or deleted

Past the free tier: an API key

When the free allowance runs out, the error tells you where to go next. Create a key at kavel.ai/settings/apikeys — the same account you use on the site — and pass it (or set KAVEL_API_KEY):

url = generate(prompt, api_key=os.environ["KAVEL_API_KEY"], model="gpt-image-2")

With a key every call runs on your account, exactly as it would on the site: your credits and plan, no per-IP ceiling, no watermark on a paid plan, and any image model your plan includes. AuthError means the key is wrong; QuotaError with a key means the account is out of credits.

Prompts that work

Kavel keeps a page per edit, each preloaded with a prompt for that specific job — hairstyle, outfit, and the rest under image tools.

MIT licensed.