Kavel SDKs

Every client in this site does the same two things — generate an image from a prompt and edit an image you already have — and none of them asks for an API key. They call the free tier of Kavel, which meters its allowance against a client id the SDK makes up on the spot instead of an account you register.

That makes them useful in the places a keyed client is awkward: a CI job that renders social cards, a prototype you want a colleague to run without sharing secrets, a teaching notebook, a cron script on a box nobody wants to configure.

Language Install Package page
Python pip install kavel pypi.org/project/kavel
Go go get github.com/hanshs474/kavel-go pkg.go.dev
Rust cargo add kavel docs.rs/kavel
TypeScript deno add jsr:@kavel/kavel jsr.io/@kavel/kavel
PHP composer require hanshs474/kavel packagist.org
Ruby gem install kavel rubygems.org/gems/kavel
Dart / Flutter dart pub add kavel pub.dev/packages/kavel
.NET dotnet add package Kavel nuget.org/packages/Kavel
Anything else two HTTP calls Raw HTTP

What one call does

  1. It mints a client id (go-…, rs-…, ts-…) — a fresh one per call, because the free wallet on an id covers three images or one edit and a reused id would stop partway through a loop.
  2. It POSTs the job and gets a task id back.
  3. It polls. Free jobs wait 25–80 seconds in a queue and are handed to the model only by the poll that crosses the end of that wait — polling is what starts the work, not just how you read it.
  4. It returns a permanent CDN URL and whether a watermark was drawn.

Two engines on the free shelf

Signed-in accounts get the rest of the shelf — Nano Banana 2, GPT Image 2, Qwen Image 3 and Seedream 5.0 Pro — plus video. See Limits and pricing.

When a script outgrows the free tier, the same SDKs take an API key and run on your account — see Using an API key.