Documentation

Quick start

You need your API key (a UUID) and your 6-digit code set at key creation. Log in at the dashboard or pass the key directly to any client.

Authentication

Pass your key in either header — both are accepted:

x-api-key: YOUR_KEY
Authorization: Bearer YOUR_KEY

Base URL for all requests:

https://api.easytokens.net/

Claude Code

1 — Install

npm install -g @anthropic-ai/claude-code

2 — Set environment variables

# Clear existing credentials first
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL

export ANTHROPIC_BASE_URL="https://api.easytokens.net/"
export ANTHROPIC_AUTH_TOKEN="your-easytokens-api-key"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"

3 — Launch

claude

Python SDK

pip install anthropic

import anthropic
client = anthropic.Anthropic(
    api_key="your-easytokens-api-key",
    base_url="https://api.easytokens.net",
)
msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content)

Node SDK

npm install @anthropic-ai/sdk

import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
  apiKey: "your-easytokens-api-key",
  baseURL: "https://api.easytokens.net",
});
const msg = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello" }],
});
console.log(msg.content);

Other apps

easytokens implements the Anthropic Messages API, so any app that lets you pick an Anthropic provider with a custom base URL works out of the box. Set the base URL to https://api.easytokens.net and use your easytokens key as the Anthropic API key. The endpoint is served on /v1/messages, /api/v1/messages and /messages, so it does not matter how the app joins the base URL and path.

Available models

Retrieve live via GET /models or GET /v1/models. Base Anthropic per-token prices are listed below.

Messages API

POST https://api.easytokens.net/v1/messages
POST https://api.easytokens.net/api/v1/messages   # legacy alias

Request and response format follows the Anthropic Messages API. Non-streaming responses include a _proxy field with cost and token breakdown. count_tokens is available at the same paths.

Error codes