支持与反馈

支持渠道

常见支持方式包括：

• 控制台工单：适合技术问题、账号问题、计费问题和故障排查。
• 在线客服：适合快速咨询和引导。
• 文档中心：适合自助查找接入说明和最佳实践。
• 企业客户经理：适合企业级配额、定制方案、私有化或商务问题。

反馈问题时请提供

• 问题发生时间和时区。
• 请求 ID 或链路追踪 ID。
• 接入点、模型名称、客户端或 SDK 版本。
• HTTP 状态码、错误码和错误信息。
• 复现步骤和最小复现样例。
• 是否影响生产环境，以及影响范围。
• 相关日志截图或文本，但不要包含完整 API Key、隐私数据或敏感上下文。

工单模板

可按以下格式提交，便于支持团队快速定位：

问题标题：生产环境调用模型持续返回 429
发生时间：2026-06-12 10:00～10:20 UTC+8
环境：production
接入点：https://api.qnaigc.com 或 https://api.modelink.ai
模型：控制台中的模型 ID
客户端：Node.js 服务 / OpenCode / Claude Code / Cherry Studio
状态码：429
错误摘要：请求触发限流
请求 ID：req_xxx，如有
影响范围：客服机器人约 20% 会话受影响
最近变更：上线了批量摘要任务，调用量增加
已尝试动作：降低并发、切换备用模型、检查 API Key
期望协助：确认限流维度、请求日志和推荐的配额治理方式

最小复现建议

最小复现不需要包含真实用户数据。建议只保留：

• 触发问题的客户端配置片段。
• 脱敏后的模型 ID、Base URL 和环境名称。
• 可复现的输入规模，例如“约 20,000 token 长文档”。
• 关键日志字段，例如请求 ID、耗时、状态码和错误摘要。

文档改进

如果发现文档缺失、示例不清晰或链接失效，请记录对应页面路径、当前描述和建议修改内容。建议同时说明你的使用场景，例如“编程工具配置”“服务端 SDK”“多模态输入”或“生产排障”。

紧急问题

生产故障、密钥泄露、异常扣费或安全事件应优先通过应急渠道处理，并保留审计信息。密钥泄露时请立即禁用旧密钥、创建新密钥并检查用量记录。