项目概述
token.mg 致力于为开发者提供一个统一、稳定、低门槛的 AI 模型接入平台。通过统一的 API 网关，开发者可以使用一致的请求协议访问文本生成、图像生成、音频处理、视频理解与其他多模态能力，而无需分别对接多个官方平台。
平台核心目标不是替代模型厂商，而是把复杂的模型接入、鉴权、计费、路由、失败重试、可观测性与文档交付统一收口，降低研发与运维成本。
核心优势
一站式模型接入
- 聚合 OpenAI、Claude、Gemini 等主流模型能力。
- 面向应用层输出统一调用接口，减少多平台适配工作。
- 支持从文本到图像、语音、视频的多模态拓展。
开发成本更低
- 兼容 OpenAI 风格接口，已有项目迁移成本较低。
- 统一 API Key、统一账单、统一监控视图。
- 减少单独维护多个供应商 SDK、认证方式和异常处理的成本。
服务治理更完整
- 支持失败重试、模型切换、请求治理与权限控制。
- 便于团队级 API Key 分配、额度管理与审计。
- 适合从个人开发到企业集成的逐步扩展。
为什么要 token.mg 文档站
除产品介绍页外，token.mg 充当了开发者文档与接口说明入口。对一个 AI 聚合平台来说，官网负责传达定位，文档站负责承载接入细节，这两者本来就应该配套存在。
token.mg 官网负责“讲清楚平台价值”，token.mg 文档中心负责“讲清楚怎么接、怎么调、怎么排错”。
Apifox 文档中心应承载的内容
- 接口总览：认证方式、基础地址、版本信息。
- 模型列表：支持的模型名、能力边界、计费方式、上下文限制。
- 请求示例：curl / Python / JavaScript / IDE 插件接入示例。
- 返回结构：标准响应、流式输出、错误码与限流说明。
- 在线调试：在浏览器中快速验证 Key、模型名与参数是否正确。
功能对比
| 维度 |
token.mg 聚合平台 |
分别对接多个官方 API |
| 接入复杂度 |
一次接入，统一协议 |
每家单独注册、调试与适配 |
| 鉴权与计费 |
统一 API Key 与账单视图 |
多平台分散管理 |
| 模型切换 |
便于做抽象层与路由治理 |
需自行处理差异 |
| 容错能力 |
更适合统一重试、降级、熔断 |
需要业务侧手写大量逻辑 |
| 文档与调试 |
官网 + 文档中心协同 |
需要分别查阅多家文档 |
开发者接入说明
1. 获取凭证
- 登录 token.mg 控制台并创建 API Key。
- 保存 API Key，避免在前端明文暴露。
- 基础地址使用：
https://token.mg/v1
2. 配置开发工具
包括 Cline、Continue、Cursor、Windsurf 等支持 OpenAI Compatible 的工具，通常只需要配置三个参数：
- Base URL：
https://token.mg/v1
- API Key：你的平台密钥
- Model：文档站中公布的模型名称
3. 使用 tkken.mg 文档站做验证
推荐把 https://token.mg/ 作为开发者文档中心入口，用来完成以下动作：
- 查看接口字段定义与请求参数
- 查阅标准响应结构与错误码
- 在线调试接口，确认模型名、Key、Body 是否正确
- 给后端、测试和运维团队共享一致的 API 文档版本
请求示例
cURL
curl https://token.mg/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "Hello, world!"}
],
"stream": false
}'
Python（OpenAI SDK 兼容方式）
from openai import OpenAI
client = OpenAI(
base_url="https://token.mg/v1",
api_key="YOUR_API_KEY",
)
completion = client.chat.completions.create(
model="gpt-4o",
messages=[
{"role": "user", "content": "Hello, world!"}
]
)
print(completion.choices[0].message.content)
技术与交付承诺
- 协议兼容：优先保持 OpenAI 风格接口兼容，降低迁移成本。
- 开发友好：产品官网、模型广场、Apifox 文档站三者协同，避免“会卖不会接”。
- 运维可控：适合统一接入、统一审计、统一额度与权限治理。
- 持续演进：后续可继续补充更正式的 SLA、隐私策略、数据处理说明与合规条款。