Agent 接入 - TokenX Intelligence

快速开始

                        cURL
                        
                    
# 1. 获取 API Key（注册后在控制台生成）
# 2. 查询实时价格
curl -X GET "https://api.token4global.com/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

# 响应：
{
  "status": "ok",
  "data": {
    "price_per_token": 0.000001,
    "currency": "USD",
    "min_order": 1000
  },
  "timestamp": "2026-08-20T06:00:00Z"
}

                        Python
                        
                    
import requests

# 配置
API_KEY = "your_api_key_here"
BASE_URL = "https://api.token4global.com/v1"

# 查询价格
resp = requests.get(
    f"{BASE_URL}/price",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
print(resp.json())

# 购买 Token
resp = requests.post(
    f"{BASE_URL}/tokens/buy",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"amount": 10000, "model": "deepseek-v3"}
)
print(resp.json())

                        TypeScript
                        
                    
const BASE_URL = 'https://api.token4global.com/v1';
const API_KEY = process.env.TOKENX_API_KEY;

// 查询价格
const price = await fetch(`${BASE_URL}/price`, {
  headers: { 'Authorization': `Bearer ${API_KEY}` }
}).then(r => r.json());

// 购买 Token
const purchase = await fetch(`${BASE_URL}/tokens/buy`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ amount: 10000, model: 'deepseek-v3' })
}).then(r => r.json());

API 概览

所有接口返回 JSON，支持 CORS。Base URL: https://api.token4global.com/v1

POST /tokens/buy STABLE

购买标准 Token，用于后续调用模型

参数	类型	说明	示例
amount	int	必填	购买数量（Token 数）	`10000`
model	string	可选	指定模型（默认 deepseek-v3）	`deepseek-v3`
sub_account	string	可选	子账户 ID（多 agent 场景）	`agent_001`

GET /balance STABLE

查询账户及子账户 Token 余额

参数	类型	说明
sub_account	string	可选	指定子账户 ID

GET /price STABLE

查询实时 Token 价格和市场深度

GET /usage STABLE

查询消费流水，支持按时间段和子账户过滤

POST /cost/calculate STABLE

计算任务预估成本和消耗

POST /execute BETA

直接调用模型（通过 Token 支付）

参数	类型	说明
model	string	必填	目标模型
prompt	string	必填	输入提示词
sub_account	string	可选	子账户 ID

认证与安全

所有 API 请求需要在 Header 中携带 API Key：

Authorization: Bearer your_api_key_here

功能	说明
API Key 管理	可在控制台创建、删除、设置限额
子账户隔离	每个 Agent 使用独立子账户，防止越权消费
低余额告警	余额低于阈值自动 webhook 通知
消费限额	支持 per-key / per-sub-account 限额

价格（按 Token 计费）

模型	架构	FLOPs/Token	价格/百万 Token
DeepSeek-V3	MOE	0.074 TFLOPs	$0.14
GPT-4o	DENSE	3.6 TFLOPs	$2.50
Claude 3.5 Sonnet	MOE	0.07 TFLOPs	$3.00
Gemini 1.5 Flash	DENSE	0.2 TFLOPs	$0.075
Llama 3.1 70B	DENSE	0.14 TFLOPs	自托管（免费）

* 价格实时更新，以 API /price 返回为准

典型使用场景

🤖 多 Agent 协作

每个 Agent 独立账户，预算隔离，防止越权消费

📊 成本控制

实时余额查询 + 低余额告警，告别账单惊吓

🔄 跨模型切换

同一 Token 账户可切换不同模型，按实际消耗计费

📈 消费审计

逐笔消费记录，可追溯、可导出、可对账

MCP Server（即将上线）

BETA Model Context Protocol 集成

允许 Claude、ChatGPT、Cursor 等 Agent 直接调用 TokenX 的算力市场

// MCP Server 启动命令（即将支持）
npx @tokenx/mcp-server \
  --api-key "your_key" \
  --base-url "https://api.token4global.com/v1"

错误响应

HTTP 状态码	错误码	说明
401	`UNAUTHORIZED`	API Key 无效或过期
403	`INSUFFICIENT_BALANCE`	余额不足
429	`RATE_LIMITED`	请求频率超限
500	`INTERNAL_ERROR`	服务器内部错误

为 AI Agent 提供可消费的算力