Getting Started

This page walks a human from zero to a successful API call. If you are an AI agent, Agent Onboarding (MCP) does the same without a browser; the agent-oriented walkthrough also lives at https://tokpum.com/agents/getting-started.md.

1. Sign in with a wallet

Go to https://tokpum.com/console/login and connect an Ethereum wallet. There is no password: the console issues a login challenge and your wallet signature proves ownership. On first sign-in an account is created for the wallet automatically.

Any EVM wallet works - connect MetaMask directly or any mobile wallet through WalletConnect. The wallet you register is also the wallet deposits must come from - see Funds.

2. Create an API key

In the console open API Keys (https://tokpum.com/console/keys) and create a key. The raw sk-... value is shown once - store it now. Losing it is not fatal: create another key and delete the old one. See FAQ for rotation.

3. Make your first call

curl -X POST https://tokpum.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"Hello"}]}'

The gateway speaks the OpenAI Chat Completions protocol, so the official OpenAI SDK works by changing only the base URL - see Compatibility.

4. Top up before real usage

Calls are billed against your account balance at the model's published prices. A fresh account has zero balance; deposit instructions are in Funds.

5. Pick models and check prices

The live model catalog and per-token prices are public - no key needed:

curl https://tokpum.com/api/v1/public/pricing

Each entry lists model_name, provider_name, channel_name, kind (chat, image, or video), and final_pricing. Video models also list their supported video_resolutions. The authenticated models endpoint lists what your key can route right now.

Next steps