Beginner 5 Minutes

Getting Started with TokenEase

Your first AI API call in 5 minutes. No credit card required.

What is TokenEase?

TokenEase is a unified API gateway for Chinese AI models. Instead of signing up for 5 different providers, you get one API key that works with:

All models use the OpenAI-compatible API format. If you've used OpenAI's API before, you already know how to use TokenEase.

Free to Start: Every new account gets $1 in free credit - enough for about 1 million tokens. No credit card required.

Step 1: Get Your Free API Key

1. Sign up at tokenease.io

Go to tokenease.io and click "Get Started Free". Enter your email address.

2. Verify your email

Check your inbox for a verification email and click the link. Your API key will be sent to you automatically.

3. Save your API key

Your API key looks like te-xxxxxxxxxxxxxxxx. Copy it and keep it secure - you'll use it in every API request.

Step 2: Make Your First API Call

Choose your preferred language and run the code below. Replace your_api_key_here with your actual key.

Python

# Install: pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://tokenease.io/v1",
    api_key="your_api_key_here"
)

response = client.chat.completions.create(
    model="deepseek",
    messages=[{"role": "user", "content": "Hello! What can you help me with?"}]
)

print(response.choices[0].message.content)

Node.js

// Install: npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://tokenease.io/v1',
    apiKey: 'your_api_key_here'
});

const response = await client.chat.completions.create({
    model: 'deepseek',
    messages: [{ role: 'user', content: 'Hello! What can you help me with?' }]
});

console.log(response.choices[0].message.content);

cURL

curl https://tokenease.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key_here" \
  -d '{
    "model": "deepseek",
    "messages": [{"role": "user", "content": "Hello! What can you help me with?"}]
  }'
Expected Output: A friendly response from DeepSeek introducing its capabilities. If you see an error, double-check your API key.

Step 3: Try Different Models

Changing models is as simple as changing one string:

# DeepSeek for coding
response = client.chat.completions.create(
    model="deepseek",
    messages=[{"role": "user", "content": "Write a Python function to reverse a string"}]
)

# GLM for Chinese content
response = client.chat.completions.create(
    model="zhipu",
    messages=[{"role": "user", "content": "写一首关于春天的诗"}]
)

# Qwen for translation
response = client.chat.completions.create(
    model="qwen",
    messages=[{"role": "user", "content": "Translate 'Hello world' to Japanese, French, and German"}]
)

# Kimi for long documents
response = client.chat.completions.create(
    model="kimi",
    messages=[
        {"role": "system", "content": "Summarize the following article:"},
        {"role": "user", "content": "[paste a 50,000 word article here]"}
    ]
)
ModelBest ForSpeed
deepseekCoding, reasoning, writingFast
zhipuChinese content, structured dataFast
qwenTranslation, multilingualFast
kimiLong documents, analysisModerate
doubaoQuick chat, low latencyFastest

Step 4: Streaming Responses

For a better user experience, stream responses word by word:

stream = client.chat.completions.create(
    model="deepseek",
    messages=[{"role": "user", "content": "Tell me a short story"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
Pro Tip: Streaming uses the same number of tokens but feels much faster to users. Always use streaming for chat interfaces.

What's Next?

Now that you've made your first API call, here are some next steps:

Common Issues

IssueSolution
401 UnauthorizedCheck your API key is correct and includes the te- prefix
429 Rate LimitedWait a moment and retry, or upgrade your plan
Empty responseCheck that messages is properly formatted as an array
Model not foundUse exact model names: deepseek, zhipu, qwen, kimi, doubao

Ready to Start Building?

Get your free API key and make your first call in 60 seconds

Get Free API Key →