SaasOne v2.0 Docs
2026-11-21·5 分钟

AI CMP 集成:第三方 AI 平台

通过 OpenAI 兼容协议接入官方 API、one-api/new-api 中转站或任意第三方 AI 平台,统一模型路由与降级。

OpenAI 兼容协议:一个变量切换平台#

AI 网关对上游的调用统一走 OpenAI 兼容协议(/v1/chat/completions),因此任何兼容该协议的平台都能直接接入 —— 官方 OpenAI、Azure OpenAI、Anthropic 网关、DeepSeek、Moonshot,以及自建的 one-api / new-api 中转站(CMP 平台)。切换平台只是两个环境变量:

env.env.local(AI 平台段)
# 官方 OpenAI
OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://api.openai.com/v1

# 或 one-api / new-api 中转站(CMP)
# OPENAI_API_KEY=sk-中转站令牌
# OPENAI_BASE_URL=https://your-cmp.example.com/v1

# 或 Anthropic 官方
# ANTHROPIC_API_KEY=sk-ant-...

模型路由与失败降级#

/api/ai/run 的 model 参数决定本次调用路由到哪个上游模型;平台不可用时网关按模型优先级自动降级重试,扣费瀑布(预存 → 月度 → 每日 → BYOK)保持不变:

多平台聚合建议
生产环境推荐自建 one-api 中转:把 OpenAI / Anthropic / 国产模型统一收敛成一个入口,平台侧故障时在 CMP 后台改映射即可切换,应用零改动。
typescript同一接口调用不同平台模型
await fetch('/api/ai/run', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ model: 'gpt-4o-mini', prompt: '你好' }),
});

// 换平台 / 换模型只改 model 字符串:
// 'gpt-4o' / 'claude-sonnet-4-6' / 'deepseek-chat' / 'moonshot-v1-8k'