alltoken

Official Python SDK for AllToken — one API for OpenAI, Anthropic, and 100+ models.

pip install alltoken

Requires Python 3.10+.

Quick start

from alltoken import AllToken

client = AllToken(api_key="...")  # or os.environ["ALLTOKEN_API_KEY"]

# OpenAI-compatible surface (maps to /v1)
resp = client.openai.raw.post(
    "/chat/completions",
    json={
        "model": "gpt-4o",
        "messages": [{"role": "user", "content": "Hello!"}],
    },
)
print(resp.json())

# Anthropic-compatible surface (maps to /anthropic)
resp = client.anthropic.raw.post(
    "/messages",
    json={
        "model": "claude-sonnet-4",
        "max_tokens": 1024,
        "messages": [{"role": "user", "content": "Hello!"}],
    },
)
print(resp.json())

The same API key works for both surfaces. Model catalog: alltoken.ai/models.

Configuration

AllToken(
    api_key="...",                      # required
    base_url="https://api.alltoken.ai", # optional, defaults to production
    default_headers={"X-My-Tag": "a"},  # optional, merged into every request
)

API surface

Field	Spec	Base URL
`client.openai.raw`	`chat.yml` (OpenAI-compatible)	`https://api.alltoken.ai/v1`
`client.anthropic.raw`	`anthropic.yml`	`https://api.alltoken.ai/anthropic`

.raw is a pre-configured httpx.Client — base URL + auth are set, call .get() / .post() / .stream() directly. Pydantic models for request/response bodies are generated from the OpenAPI specs into alltoken.generated.chat and alltoken.generated.anthropic.

Status

v0.1.0 — Scaffold. Pydantic models are generated from the spec, the wrapper surface is minimal. Expect breaking changes in 0.x. Ergonomic helpers (client.chat.completions.create(...), async streaming iterators, retries, etc.) are coming in 0.2.x.

Contributing / Local development

# Clone megaopenrouter as a sibling (for the OpenAPI specs)
git clone git@gitlab.53site.com:ai-innovation-lab/megaopenrouter.git ../megaopenrouter

# Install with dev deps
pip install -e ".[dev]"

# Regenerate pydantic models from specs
python scripts/generate.py

# Test + lint
pytest
ruff check
mypy .

Generated models live in src/alltoken/generated/{chat,anthropic}.py — these are committed so users who install from PyPI don't need to run codegen.

License

MIT

Metadata

Release files for alltoken 0.2.32

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alltoken 0.2.32
File	Size	Uploaded
alltoken-0.2.32.tar.gz	25.1 kB	Aug 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for alltoken 0.2.32
File	Interpreter	ABI	Platform	Reset
alltoken-0.2.32-py3-none-any.whl 28.4 kB Aug 13, 2026	Python 3	none	any	Details

Total release size: 53.4 kB

Release files / alltoken-0.2.32.tar.gz

Download URL	alltoken-0.2.32.tar.gz
Size	25.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`1b64c7ac46dd003924bc2121f03cdd0c4dec5c376de68ae44b1b64cbb9983d53`
BLAKE2b-256 checksum How to use checksums	`d0580c59331e3337ad9d6f7771645839566bd9b7c3b09dd58df285dd7001588a`
Upload date	Aug 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / alltoken-0.2.32-py3-none-any.whl

Download URL	alltoken-0.2.32-py3-none-any.whl
Size	28.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`77af0dccacc8623cf81b4e1ff6e7d0f25fd8ba77d15c77d137c464ddc8e7c3aa`
BLAKE2b-256 checksum How to use checksums	`5acac82f3fadbcbe5262a1a89437b4601d544ea621f8ddc1d268f3a852fa784b`
Upload date	Aug 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`