Authentication

The SDK authenticates with a project API key — a key ID / secret pair. There is no other authentication mode.

Create a Key

API keys are created in the TouAI web console under Settings → API Keys. Account, organization, project, and API-key management are console features — they are not part of the SDK.

Configure the Client

from touai import TouAI
 
client = TouAI(
    access_key_id="ak_live_...",
    secret_key="sk_live_...",
)

Explicit constructor arguments take precedence over the environment variables.

What Lives Where

Task	Where
Calling platform services	SDK (`TouAI` / `AsyncTouAI`)
Creating, rotating, revoking API keys	Web console (Settings → API Keys)
Login, account and organization management	Web console
Purchases and subscription changes	Web console

API key secrets are shown once, at creation time. Store them immediately in your secret manager — the console can rotate a key, but it cannot display an existing secret again.

Keys are scoped to one project: everything the client creates or reads belongs to that project. Use a separate key per project or environment.

Installation Configuration