配置前准备三项信息
先在 Modb API 控制台创建项目密钥，再从模型广场确认准确的模型标识。多数 OpenAI 兼容配置使用 https://modbapi.com/v1，但个别工具会自动追加 /v1 或接口路径，填写前应查看对应教程。
建议先使用新建的测试密钥和小额额度完成一轮对话，再启用知识库、工具调用或自动化工作流。
- Base URL
- 项目 API Key
- 模型标识
- 测试额度与权限
客户端配置的常见差异
不同工具对“API Host”“Base URL”“Provider”或“自定义模型”的命名不同。有些工具要求填写完整 /v1 地址，有些会自行拼接版本路径。模型下拉列表未自动出现时，通常需要手动添加模型标识。
Cline 等编程工具会产生较长上下文，Dify 和 OpenWebUI 还可能由服务端转发请求。应根据实际部署位置配置网络、超时和并发。
安全和故障排查
不要在截图、公开配置文件或共享工作区暴露完整 API Key。团队使用时应按成员或项目拆分密钥，便于撤销和核对用量。
遇到失败时依次检查最终请求地址、鉴权头、模型名称、账户额度和客户端日志。401、404、429 分别优先排查密钥、路径或模型、频率或额度。
常见问题
关于AI 客户端与开发平台接入的常见问题
所有 OpenAI 客户端都能直接使用吗？
支持自定义 Base URL 和模型名称的客户端通常可以，但高级能力需要逐项验证。
Base URL 是否一定包含 /v1？
多数配置需要 /v1，部分工具会自动追加，具体以对应工具教程为准。
为什么模型列表是空的？
检查接口地址和密钥，或在客户端中手动添加模型广场展示的模型标识。
团队可以共用一个密钥吗？
不建议。按项目或成员拆分密钥更便于限额、撤销和用量核对。