Search the documentation

Pick a page and open it with Enter.

Installation

Call the API with a key and curl — SDKs coming soon.

There is nothing to install yet. You call the HTTP API directly — a bearer token and a request. Typed SDKs for TypeScript, Python and Go are on the way.

SDKs are coming

Official clients will wrap this API as thin, typed packages (npm, pip, go get). Nothing about the API changes when they land — build against the HTTP endpoints today and swap in a client later.

Call it with curl

Send your key as a bearer token. Locally, against your own machine, no key is needed at all — a bare request works. See Authentication for when keys are required and how to create one.

bash
curl -N https://your-host/api/v1/chat/stream \
  -H "Authorization: Bearer sk_smee_…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

Configuration

Keep the key and the base URL in your environment rather than in code. Locally the base URL is http://127.0.0.1:8000/api/v1 and no key is needed; in production use your own host and a key created under Settings → API keys.

.env
SMEEWARE_API_KEY=sk_smee_…
SMEEWARE_BASE_URL=https://your-host/api/v1