Native API — Introduction

The native surface lives under /api/v1 on your API host. It powers the TokenSaver console and the Python SDK. Governance (workspace, quotas, plans, metering) is always scoped to your TokenSaver API key.

The SDK is a thin HTTP client: orchestration, cache, RAG, compression, PII, and billing run on TokenSaver servers. Every call is auditable in the platform.

One contract

Same provider/model parameters; catalogue enforced in the database.

History modes

Stateless, local SDK memory, or server-persisted chats.

Console parity

Optional flags match the pipeline JSON you send from the UI.

Default hosted base URL

https://api.tokensaver.fr/api/v1 — override with base_url for self-hosted or staging stacks.

Next: Authentication · Run pipeline.