核心特性
primerouter 围绕统一接入、透明计费、审计可证三个目标设计。下面按对外可见的能力维度展开。
模型与供应商
多供应商一键接入
覆盖国际与中国前沿模型，包括但不限于：
- 国际：OpenAI（GPT-4o、o-series）、Anthropic（Claude 系列）、Google（Gemini 系列）、Mistral、Cohere、xAI（Grok）、Meta Llama
- 中国：DeepSeek（V3 / R1）、阿里 Qwen、智谱 GLM、Moonshot Kimi、MiniMax、字节豆包、百度文心、腾讯混元、讯飞星火
- 特殊：Ollama（本地）、SiliconFlow、Dify、Coze、Replicate
模型清单与计价见 Pricing → Models。
多 API 格式原生支持
不止 OpenAI 兼容。Claude 和 Gemini 的原生格式也直接支持，意味着 Claude SDK / Google AI SDK 也能直连：
| 格式 | 端点 | 用途 |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions | 最广泛 |
| OpenAI Responses | /v1/responses | OpenAI 新格式 |
| OpenAI Embeddings | /v1/embeddings | 向量嵌入 |
| OpenAI Images / Audio | /v1/images/..., /v1/audio/... | 多模态 |
| Anthropic Messages | /v1/messages | Claude 原生 |
| Google Gemini | Gemini 原生路径 | Gemini 原生 |
中间层自动做格式转换。你可以不改代码切换上游：用 OpenAI 格式调 Claude、用 Claude 格式调 Gemini，都行。
多模态
| 模态 | 能力 |
|---|---|
| 文本对话 | Chat Completions / 流式 / 多轮 / 工具调用 / 推理 |
| 嵌入向量 | OpenAI / Cohere Embed |
| 图像生成 | DALL·E、Midjourney、即梦 |
| 语音 | TTS / STT（OpenAI、火山、MiniMax） |
| 视频生成 | Sora、Kling、Hailuo、Vidu、即梦、豆包（异步任务） |
| 音乐生成 | Suno |
| 排序 / Rerank | Cohere、Jina、阿里 |
视频/音乐这类长任务通过异步任务系统：提交→预扣→轮询→结算。详见 功能介绍 → 异步任务。
路由与可用性
智能路由
- 加权随机：按权重概率分配到多个上游
- 优先级重试：高优先级失败自动降级到下一档
- 跨分组重试：
auto令牌可跨分组逐个尝试 - 频道亲和：同用户同模型默认绑定同渠道，减少上下文切换
多 key 故障隔离
单条上游渠道支持多 key 轮换（轮询 / 随机 / 加权），单 key 故障自动跳过，不影响其他 key。
自愈
- 渠道连续失败 AutoBan，恢复后自动启用
- 实时响应延迟监控
- 余额预警（上游账户余额不足提前通知）
- 定期健康测试
计费与支付
按 token 计费，无订阅
- 真实 token 数 × 模型单价 = 账单。无月费、无套餐、无最低消费。
- 用量字段与上游官方返回字节级一致，可点开每条请求查上游账本。
- 账户余额不足按调用前预扣 → 实际结算 → 多退少补。
多种充值方式
- 加密货币（差异化能力）：USDT / USDC 等，多链支持（EVM、Aptos 等）。链上确认即到账，详见 加密支付。
- 信用卡 / Apple Pay / Google Pay（Stripe）
- 本地支付方式（Waffo，覆盖 162 国 480+ 种）
- 兑换码 / 邀请奖励
内置 Chat（产品级聊天）
不只是 API 网关——内置面向终端用户的聊天界面：
- 会话管理：创建、重命名、归档、置顶、删除
- 模型切换：对话中随时切换
- 流式输出 + 推理过程展示（Reasoning Block）
- 工具调用：网页搜索、URL 阅读、代码仓库浏览
- 文件 / 图片上传
- 历史压缩
- 会话分享（chat2link）：生成只读分享链接，无需登录可看
- 完整 Markdown / 代码高亮 / KaTeX / Mermaid
Playground
可视化 API 调试台：模型选择、参数滑块、请求体编辑、SSE 实时查看、代码片段一键复制、保存测试配置。
控制台
登录后即用，所有用户可见：仪表盘、个人中心、令牌、充值、用量、Playground、模型列表、订阅、兑换、Chat、Midjourney、异步任务。详见 功能介绍。
管理员
仅管理员可见的高级能力（上游渠道管理、模型部署、用户管理、分组与定价、系统设置）属于站点运维范畴，本用户文档不展开。
安全
- OAuth：GitHub、Discord、OIDC、LinuxDO 等
- Passkey（WebAuthn）+ 2FA TOTP
- 人机验证（Cloudflare Turnstile / hCaptcha）
- API key 维度的：模型限制、IP 白名单、配额上限、过期时间
- SSRF 防护、用户 + 模型双重限流、CORS、请求 Trace ID
国际化
文档与产品界面同步支持 7 种语言：简体中文、English、繁體中文、日本語、Français、Русский、Tiếng Việt。