AI API 客服工单回复模板：模型不可用、401、余额不足和 stream 排查

用户反馈 model not found、401、402、429、超时或 stream 输出中断。

客服需要收集排查证据，但不能让用户发送完整 API Key。

同类问题反复出现，需要把回复沉淀为 FAQ、答案页和站内搜索内容。

{{user_name}}: 用户称呼或账号昵称。

Example: 张同学

Safety: 不要在公开模板里写真实手机号、邮箱或内部用户 ID。

{{client_name}}: 用户使用的客户端、SDK 或调用方。

Example: Cursor / Cherry Studio / Python SDK

Safety: 只记录软件名称和版本，不要求用户上传完整本地配置文件。

{{model_name}}: 用户实际填写的模型调用名。

Example: deepseek-chat

Safety: 要求复制后台模型列表里的真实调用名，不用营销简称替代。

{{error_message}}: 状态码和错误原文。

Example: 401 unauthorized / model not found

Safety: 可以保留错误文本，但不要保留完整请求头、完整 API Key 或隐私提示词。

{{masked_key}}: 脱敏后的密钥标识。

Example: sk-...9a2f 或后台 key id

Safety: 只保留前后少量字符或后台 key id，不能让用户发送完整密钥。

首次回复

先确认问题类型和需要的非敏感字段，避免客服一开始就让用户发完整截图或完整密钥。

您好，收到您的反馈。为了快速定位 AI API 调用问题，请先提供以下非敏感信息：使用的客户端或 SDK、API Base URL、模型调用名、请求时间、状态码、错误原文，以及脱敏后的 API Key 标识。请不要发送完整 API Key、完整请求头、账号余额截图或包含隐私内容的提示词。

模型不可用或 model not found

把排查重点放在模型调用名、分组权限、上游可用性和迁移后的模型映射上。

如果提示 model not found 或模型不可用，请先核对后台模型列表中的真实调用名，再确认当前密钥所在分组是否有该模型权限。若您刚从 New API / One API 或其他入口迁移，请同时检查旧模型名和新模型名的映射关系。请把模型名、请求时间和错误原文发给我们，我们会用脱敏记录继续排查。

401、402 和余额不足

区分鉴权失败、账号余额不足、分组额度不足和单 key 限额。

401 通常表示密钥无效、密钥被禁用或 Base URL 填写到了错误入口；402 或余额不足可能来自账号余额、分组额度或单个 API Key 限额。请确认您使用的是后台生成的有效 API Key，并提供脱敏 key 标识、分组名称、请求时间和错误原文。我们不会索要完整 API Key。

stream 中断或无输出

stream 问题常常来自客户端、代理、超时和缓冲设置，不一定是模型不可用。

如果普通请求可用，但 stream 输出中断或长时间无内容，请先关闭代理缓存，确认客户端支持 SSE 流式输出，并用同一模型测试一次 stream=false。请提供客户端名称、版本、是否开启 stream、请求时间、状态码和错误文本，方便判断是客户端、网络代理、超时还是上游响应问题。

AI 生图生视频任务失败

异步任务必须保留 task ID、输入类型、参数和下载状态。

AI 生图或 AI 生视频失败时，请提供任务 ID、输入类型、提示词摘要、比例、分辨率、数量或时长、参考图说明、提交时间和错误原文。请不要发送未授权素材、私人人像原图或包含隐私信息的完整提示词。我们会根据任务记录判断是参数不合规、排队、上游失败、下载失败还是额度问题。

把模板放进客服知识库，并标注哪些字段可以公开收集、哪些字段不能收集。

把高频问题拆成 FAQ、答案页和站内搜索关键词，减少重复工单。

每周复盘客服仍然需要追问的字段，把模板补充得更具体。

把模型名、Base URL、余额和 stream 相关问题链接到对应指南和术语页。

模板没有索要完整 API Key、完整请求头、账号余额截图或用户隐私提示词。

每类问题都有状态码、模型名、时间、客户端和脱敏 key 标识等证据字段。

回复语气清楚，不把所有问题都归因于用户配置错误。

模板能链接到公开 FAQ、答案页、指南、术语页和工单清单。

This template provides customer support replies for AI API troubleshooting.

It covers model not found, 401, insufficient balance, streaming failures, and AI image/video task failures.

The template emphasizes non-sensitive evidence collection and avoids complete API keys, private prompts, account balances, and internal routing data.

客服可以要求用户发完整 API Key 吗？

不建议。公开回复和工单里只应收集脱敏 key 标识、后台 key id、状态码、模型名、时间和错误文本，完整 API Key 会带来安全风险。

为什么客服模板也属于 SEO/GEO 内容？

真实客服问题往往就是长尾搜索词。把可公开的排查逻辑沉淀为模板、FAQ 和答案页后，更容易被搜索引擎和 AI answer engine 引用。