Agents

SDKs

Typed clients for TypeScript and Python are on the way, generated from the same OpenAPI document as these pages. Until they ship, the API is small enough to call directly.

Coming

Language	Package	Registry	Status
TypeScript	@kinoseed/sdk	npm	coming
Python	kinoseed	PyPI	coming

Both will wrap the calls on these pages and add a waitForJob helper. Until they are published, npm install @kinoseed/sdk and pip install kinoseed will not find them.

Meanwhile: fetch and httpx

Start a run (pick the TypeScript or Python tab):

Start a run

curl -X POST https://kinoseed.app/api/v1/images \
  -H "Authorization: Bearer ks_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-hero" \
  -d '{
    "prompt": "a ceramic mug on a sunlit desk, product photo",
    "model": "nano-banana-pro",
    "aspect": "1:1",
    "count": 2
  }'

And wait for it:

Wait for the result

# Hold the response up to 50 seconds while the job runs.
curl "https://kinoseed.app/api/v1/jobs/JOB_ID?wait=50" \
  -H "Authorization: Bearer ks_live_YOUR_KEY"

Every operation has the same three samples on its page and in the reference.