👤 User Manual

Manage your API keys, top up your wallet, integrate with SDKs

🔑 API Key Management

Creating an API Key

1Log in to the Console → Token Management

2Click the Add Token button

3Enter a label (e.g. "Production", "Testing")

4Select a group/permission (optional)

5Copy the key immediately — it's only shown once

⚠️ Keep your API keys secure. Never commit them to public repositories. If you suspect a leak, revoke the key in Token Management and create a new one.

Managing Keys

In Token Management, you can:

View — see all keys, status, last used timestamp
Edit — rename keys or change group assignments
Enable/Disable — temporarily suspend a key without deleting it
Delete — permanently remove a key (irreversible!)

Using Your Key

Pass it in the Authorization header of every API request:

Authorization: Bearer sk-xxx...

🤖 Model Selection Guide

Use Case	Recommended Model	Notes
General chat / Quick tasks	`deepseek-chat`, `qwen-plus`	Fast, cost-effective
Complex reasoning / Coding	`deepseek-reasoner`, `claude-sonnet`	Strong logic, high code quality
Long context / Document analysis	`kimi-k2`, `doubao-pro`	Very long context windows
Creative writing (Chinese)	`glm-4`, `qwen-max`	Excellent Chinese expression
Multi-turn conversations	`gpt-4o`, `claude-sonnet`	Accurate context understanding

💡 Best practice: implement automatic fallback — if your primary model fails, switch to a backup model.

💰 Top-Up Guide

Payment Methods

Credit/Debit Card — Visa, Mastercard, American Express
PayPal — pay with your PayPal balance or linked card
Cryptocurrency — Bitcoin, Ethereum, USDT (coming soon)

How to Top Up

1Console → Wallet Management → Quota Top-up

2Select amount ($10 / $20 / $50 / $100 / $200 / $500 or custom)

3Choose payment method

4Complete payment — funds arrive instantly

Plans Comparison

Amount	You Pay	Credit Received
$10	$10.00	$10.00
$20	$20.00	$22.00 (10% bonus)
$50	$50.00	$57.50 (15% bonus)
$100	$100.00	$120.00 (20% bonus)
$200	$200.00	$240.00 (20% bonus)
$500	$500.00	$600.00 (20% bonus)

📊 Usage Monitoring

The Dashboard gives you real-time visibility into:

Balance — current wallet balance
Request count — today / this week / this month
Token consumption — input vs output tokens
Model distribution — which models are using the most
Spending trends — daily/weekly/monthly charts

🔌 SDK Integration

Python (OpenAI SDK)

import openai
from openai import OpenAI

client = OpenAI(
    base_url="https://www.tokencnn.com",
    api_key="***"
)

# Chat
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Hello"}]
)

# Embeddings
emb = client.embeddings.create(
    model="text-embedding-3-small",
    input=["Hello world"]
)

# Image generation
img = client.images.generate(
    model="dall-e-3",
    prompt="Chinese landscape painting, digital art"
)

Node.js (OpenAI SDK)

import OpenAI from "openai";

const client = new OpenAI({
    baseURL: "https://www.tokencnn.com",
    apiKey: "***",
});

const response = await client.chat.completions.create({
    model: "deepseek-chat",
    messages: [{ role: "user", content: "Hello!" }],
});

cURL

curl https://www.tokencnn.com/v1/chat/completions \
  -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

⚡ Rate Limits

Limit	Description
Rate limiting	Varies by model and plan — check the console for details
Concurrency	Depends on your subscription plan
Timeout	120 seconds default

💡 Hit a rate limit? Wait a moment and retry, or upgrade your plan for higher quotas.