AI 提供商

AI 提供商页面决定 CPA 如何把客户端请求转发到上游模型服务。这里配置的是模型服务本身，不是 CPAMP 管理员登录，也不是 CPA Management Key。

如果你要改 Manager Server 连接、采集器或运行时开关，请去 配置中心。

支持的配置类型

页面会按提供商类型管理配置，常见类型包括：

• Codex
• Claude Code
• Gemini / AI Studio
• Vertex
• OpenAI-compatible

不同提供商需要的字段不完全一样，但都围绕几个核心问题：请求发到哪里、用什么凭证、用哪些模型、是否启用、请求头或兼容接口是否需要特殊处理。

新增或编辑提供商

1. 点击添加配置，选择提供商类型。
2. 填写名称、Base URL、API Key、认证文件或 OAuth 相关字段。
3. 如果页面要求 auth_index，使用稳定且唯一的值，方便用量、配额和巡检关联到同一个账号。
4. 配置模型列表或模型规则。不要把客户端模型名、提供商实际模型名和模型价格名混在一起。
5. 保存后发一条低成本请求。
6. 到 请求监控 查看请求是否命中预期提供商、模型和账号。

字段怎么判断

• Base URL：应指向上游模型服务或 CPA 期望的兼容接口，不是 CPAMP 文档站或管理面板地址。
• API Key：是提供商或客户端调用密钥。不要填 CPA Management Key 或 CPAMP Admin Key。
• 认证文件：适合 OAuth 或账号文件类提供商。维护账号状态时去 认证文件。
• 模型列表：影响客户端可见模型和路由匹配。成本估算还需要 模型价格 中存在对应模型名。
• 启用状态：停用配置后，CPA 不应继续把新请求路由到该配置。

保存后验证

最可靠的验证方式不是只看“保存成功”，而是发一条真实请求：

1. 用客户端请求一个低成本模型。
2. 在 请求监控 中确认提供商、模型、账号和状态码。
3. 如果请求成功但成本为空，检查 模型价格。
4. 如果请求失败且像认证问题，检查 认证文件 或 OAuth 登录。
5. 如果页面没有出现请求事件，先排查请求监控采集链路。

常见问题

• 保存后模型仍不可用：确认配置已启用、模型名匹配、客户端请求经过 CPA。
• 请求打到错误提供商：检查路由规则、模型别名和配置顺序。
• 只在某些账号失败：进入认证文件或 Codex 账号巡检，按 auth_index 查账号状态。
• 成本估算不对：提供商配置不决定价格，去模型价格页维护对应模型。