Skip to main content

API Keys

All requests require an API key. Keys are prefixed with kf- and can be created from the dashboard.

Option 1 — Pass directly

import kitefishai

client = kitefishai.Client(api_key="kf-...")
Set KITEFISH_API_KEY in your environment and the client picks it up automatically:
export KITEFISH_API_KEY="kf-..."
client = kitefishai.Client()
This is the recommended approach. It keeps credentials out of source code.

Option 3 — .env file

Use a library like python-dotenv:
# .env
KITEFISH_API_KEY=kf-...
from dotenv import load_dotenv
load_dotenv()

import kitefishai
client = kitefishai.Client()
Never commit API keys to source control. Add .env to your .gitignore.

On-prem deployments

For air-gapped enterprise deployments, override the base URL:
client = kitefishai.Client(
    api_key="kf-...",
    base_url="https://your-internal-host/v1",
)
Or via environment:
export KITEFISH_BASE_URL="https://your-internal-host/v1"