Quickstart
Install TokenID and capture your first AI API call in under five minutes.
1. Install
TokenID is distributed via a private registry. You authenticate with your TokenID API key.
pip install --extra-index-url https://tokenid:@pypi.token.audit.id/simple/ tokenid
Or add it to your requirements.txt:
--extra-index-url https://tokenid:@pypi.token.audit.id/simple/
tokenid
2. Get your API key
Log in to token.audit.id/app → Settings → API Keys → New Key.
Your key starts with td_live_.
3. Set your environment variable
export TOKENID_API_KEY=td_live_xxxx
4. Wrap your client
Pick the provider you use:
```python
# Before
import anthropic
client = anthropic.Anthropic(api_key="sk-ant-…")
# After
from tokenid import JournaledAnthropic
client = JournaledAnthropic(api_key="sk-ant-…", session_id="my-session")
```
```python
# Before
import openai
client = openai.OpenAI(api_key="sk-…")
# After
from tokenid import JournaledOpenAI
client = JournaledOpenAI(api_key="sk-…", session_id="my-session")
```
```python
# Before
import openai
client = openai.OpenAI(api_key="xai-…", base_url="https://api.x.ai/v1")
# After
from tokenid import JournaledGrok
client = JournaledGrok(api_key="xai-…", session_id="my-session")
```
The wrapper passes all arguments through to the real SDK unchanged. If the ingest call fails, your API call still succeeds.
5. Make a call
Your existing code works without modification:
response = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}]
)
6. Check your dashboard
Open token.audit.id/app. The call appears under Events within seconds, with cost, token counts, model, and session ID.
✓ You're live. Every call you make is now captured and audited.