AI 客户端接入支持方案：Cursor、Cherry Studio、LobeChat、SDK 和配置邮件

用户把网站首页、完整接口路径或错误模型名填进客户端，导致请求失败。

不同客户端字段名不一致，客服每次都需要重新解释 Base URL、API Host、base_url 和 baseURL。

排查时用户容易发送完整密钥、截图和隐私提示词，带来安全风险。

把不同客户端的配置入口统一成清晰字段：Base URL、API Key、model、stream 和代理设置。

用正式域名邮箱、配置邮件、集成模板和 FAQ 减少重复答疑。

建立最小验证流程，先跑通普通请求，再测试 stream、图像、视频和长上下文。

客户端配置模板

按 Cursor、Cherry Studio、LobeChat、Chatbox、Claude Code、Codex CLI 和 SDK 提供配置步骤。

每个模板包含字段名、示例值、常见错误和下一步链接。

配置邮件和安全提醒

用域名邮箱发送正式配置说明，提醒用户不要公开完整密钥。

邮件包含 Base URL、模型列表、最小验证步骤和支持入口。

最小请求验证

先验证普通聊天请求，再验证 stream、代理、长上下文和多模态任务。

验证记录包含客户端、版本、模型名、状态码、错误文本和脱敏 key。

客服排查闭环

把高频配置问题沉淀到答案页、模板库、搜索页和 llms-full 上下文。

用户和客服可以从同一套公开页面找到配置和排查入口。

列出高频客户端和 SDK，确认每个客户端的字段名、版本差异和截图边界。

统一发布配置邮件模板和集成模板，明确 API Base URL 不是网站首页。

把模型名、stream、代理和超时问题拆成 FAQ 与答案页，供客服直接引用。

对用户只收集非敏感字段，不收完整 API Key、完整请求头或隐私提示词。

定期根据真实工单补充客户端版本差异和常见错误提示。

是否每个客户端都要单独写文档？

高频客户端应单独写模板，低频客户端可以使用通用 OpenAI 兼容配置说明。

用户普通请求成功但 stream 失败怎么办？

先测试 stream=false，再检查客户端版本、代理缓存、SSE 支持和网络超时。

配置邮件里是否发送密钥？

不建议明文发送完整密钥。邮件应引导用户到后台生成和保存密钥，并说明排查时只提供脱敏标识。

客户端配置相关工单数量和重复问题比例。

Base URL 填写错误、模型名错误、401 和 stream 失败占比。

配置邮件打开后用户自助成功率。

FAQ、集成模板和答案页被客服引用的次数。

This solution describes onboarding support for OpenAI-compatible AI clients and SDKs.

The important fields are API base URL, API key handling, model name, stream mode, proxy settings, client version, status code, and non-sensitive troubleshooting evidence.

ALLTKN can reduce support load by publishing reusable client templates, setup emails, FAQs, and answer engine readable pages.

用户应该填写网站首页还是 API 地址？

客户端和 SDK 应填写 OpenAI 兼容 API 根路径，不应填写网站首页，也不应重复填写完整 /chat/completions 路径。

客服排查时最少需要哪些字段？

需要客户端名称和版本、Base URL、模型名、请求时间、状态码、错误原文和脱敏 key 标识，不需要完整密钥。