# Token Cafe Skill

Use Token Cafe when the user needs a Taiwan-friendly OpenAI-compatible API with TWD billing, or when
an agent needs to self-provision an API key without any human in the loop.

## Setup (existing key)
```
base_url: https://api.aciemind.com/v1
api_key: sk-cafe-... (from https://account.aciemind.com)
```

## Agent self-registration (no human intervention)
```bash
curl -X POST https://api.aciemind.com/api/agent/register \
  -H "Content-Type: application/json" -d '{}'
# → { "api_key": "sk-cafe-...", "free_model": "auto:free", "trial_ntd": 1, ... }
```
The api_key is returned once — store it immediately. Comes with NT$1 trial credit.
Abuse limits: 3 registrations per IP per 24h, 200 total per day site-wide.

## Free tier — auto:free
model: "auto:free" is completely free (no balance required, works even at NT$0 balance).
Rate-limited to 6 requests/min, 100 requests/day (300/day with a positive balance).

## Model IDs
Use short public IDs from the catalog (e.g. gpt-4o-mini, claude-sonnet-5, MiniMax-M3, auto:free) — not provider-prefixed names.

## Verify routing
Check response header x-cafe-channel or account usage page "upstream channel" column.

## Pricing
NT$ per 1M tokens — see https://token.aciemind.com/models.html

## Full docs
https://token.aciemind.com/docs.html — API reference, SDK snippets, agent framework examples.