第一步，立即检查项

检查密钥输入

• ✅ 确认没有多余的空格或换行符
• ✅ 区分大小写（特别是字母O和数字0、字母l和数字1）
• ✅ 确保完整复制，没有遗漏字符
• ❌ 不要分享密钥截图或直接粘贴到公开场合

验证密钥状态

• 登录 AI小龙虾养护平台控制台
• 导航到“API管理”或“开发者设置”
• 检查密钥状态是否为“激活”
• 查看是否有过期时间限制

第二步：常见原因及解决方法

可能性A：密钥被重置或撤销

解决方法：
1. 重新生成新API密钥
2. 更新所有使用该密钥的应用程序
3. 立即停用旧密钥

可能性B：权限不足

检查项目：
- 确认密钥有访问所需API的权限
- 检查IP白名单设置（如有）
- 验证API调用频率是否超限

可能性C：环境配置问题

排查步骤：
1. 测试环境 vs 生产环境密钥是否混淆
2. 检查.env或配置文件是否被意外修改
3. 验证服务器时间是否同步（时区问题）

第三步：快速诊断脚本

如果你有编程环境,可以运行这个简单的测试：

import requests
api_key = "你的API密钥"
url = "https://api.crayfish-ai.com/v1/status"  # 替换为实际端点
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(f"状态码: {response.status_code}")
print(f"响应内容: {response.text}")

第四步：联系技术支持

如果以上步骤都无法解决,请准备以下信息联系客服：

1. 账户信息：注册邮箱/用户名
2. 密钥前缀：前6位字符（如：sk-abcde）
3. 错误详情：
   • 完整错误信息
   • 发生时间
   • 调用的API端点
4. 环境信息：
   • 使用的编程语言/工具
   • 请求头信息

预防措施

1. 密钥管理最佳实践：

   • 使用环境变量存储密钥
   • 定期轮换密钥（每3-6个月）
   • 为不同应用创建不同密钥

2. 监控设置：

   • 启用API调用日志
   • 设置使用量告警
   • 监控异常调用模式

紧急处理

如果密钥泄露或怀疑被盗用：

1. 立即在控制台撤销该密钥
2. 生成新密钥并更新所有应用
3. 检查近期的API调用记录

请先尝试第一步和第二步的检查，大多数情况下问题都能快速解决，如果需要进一步协助，可以提供更多错误细节，我会帮你分析具体原因。

标签： 第一步 检查项