OpenAI 兼容客户端配置邮件模板：Base URL、API Key、模型名和安全提醒

新用户注册、购买或开通后，需要收到标准化接入说明。

用户经常把网站首页填进 API Base URL，导致请求失败。

团队希望用自己的域名邮箱发送更正式的配置和验证邮件。

{{recipient_name}}: 收件人称呼。

Example: 王同学

Safety: 群发时避免把多个客户邮箱放在同一个收件人列表里。

{{api_base_url}}: OpenAI 兼容 API 根路径。

Example: https://api.alltkn.com/api/v1

Safety: 不要把网站首页或完整接口路径写成 Base URL。

{{model_list_url}}: 后台模型列表或文档链接。

Example: https://alltkn.com/docs

Safety: 模型调用名要以后台列表为准。

{{support_contact}}: 支持邮箱或工单入口。

Example: support@alltkn.com

Safety: 明确说明不要通过邮件发送完整 API Key。

配置邮件正文

邮件要像正式服务通知，而不是随手发一段聊天记录。

您好 {{recipient_name}}，您的 ALLTKN AI API 接入已开通。请在支持 OpenAI 兼容接口的客户端或 SDK 中填写以下配置：API Base URL：{{api_base_url}}；API Key：请在后台密钥页面生成并妥善保存；模型名：请以后台模型列表或 {{model_list_url}} 为准。请不要把网站首页或完整 /chat/completions 路径填进 Base URL。

客户端提示

不同客户端字段名不同，但核心字段一致。

常见客户端字段名可能是 Base URL、API Host、OpenAI API Base、base_url 或 baseURL。它们都应填写 OpenAI 兼容 API 根路径。API Key 只应保存在您自己的客户端、服务端环境变量或后台密钥页面中，不要发送到公开群聊、截图或工单里。

最小验证步骤

帮助用户先跑通最小请求，减少复杂任务带来的误判。

建议先用一个最小聊天请求验证 Base URL、API Key 和模型名。普通请求成功后，再测试 stream 流式输出、长上下文、AI 生图或 AI 生视频任务。如果普通请求成功但 stream 失败，请检查客户端版本、代理缓存和网络超时设置。

安全提醒

正式邮件必须明确密钥边界。

安全提醒：ALLTKN 客服不会索要完整 API Key。排查问题时，请只提供客户端名称、模型名、请求时间、状态码、错误原文和脱敏 key 标识。如果您怀疑密钥泄露，请立即在后台禁用旧密钥并重新生成。

把邮件发件人改为域名邮箱，例如 support@alltkn.com 或 no-reply@alltkn.com。

邮件正文只放必要配置、文档链接、安全提醒和客服入口。

把同一套字段同步到注册成功页、FAQ、客户端配置指南和站内搜索。

跟踪用户仍然报错的字段，把邮件模板继续补充具体客户端说明。

邮件发件人使用域名邮箱，主题清楚，正文不混用私人邮箱口吻。

Base URL、API Key、模型名和 stream 的解释清楚。

安全提醒明确不索要完整 API Key。

邮件链接到文档、集成模板、FAQ 和客服入口。

This template is an email for OpenAI-compatible client setup.

It covers API base URL, API key handling, model names, streaming validation, client field names, and safe troubleshooting.

The template is suitable for onboarding emails, verification-adjacent product messages, support replies, and answer engine references.

配置邮件里可以直接发送 API Key 吗？

不建议。邮件可以说明用户到后台生成和保存 API Key，但不应明文发送完整密钥，尤其不应群发或转发。

为什么要使用域名邮箱发送？

域名邮箱更像正式服务通知，也更便于配置 SPF、DKIM、DMARC，降低邮件被拦截或被用户误认为私人消息的概率。