问题表现

调用API时返回AuthFailure.SignatureFailure或AuthFailure.SecretIdNotFound错误。

常见原因

• SecretId或SecretKey错误
• 签名算法不正确
• 请求时间戳过期（超过5分钟）

解决方案

1. 登录腾讯云控制台，检查API密钥是否正确
2. 确认签名算法符合腾讯云规范
3. 检查服务器时间是否准确

注意：SecretKey只在创建时显示一次，请妥善保存。如果丢失，需要重新创建密钥对。

问题表现

返回TokenPlanExhausted或TokenPlanNotActive错误。

排查步骤

1. 登录腾讯云控制台，查看Token Plan状态
2. 确认套餐是否已到期或用尽
3. 检查是否选择了正确的模型

问题表现

请求发出后长时间无响应，最终超时。

可能原因

• 网络不稳定或防火墙拦截
• 模型响应时间过长（输入内容过多）
• API服务端限流

解决方案

// 设置合理的超时时间
const response = await fetch('https://api.example.com/v1/chat', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    signal: AbortSignal.timeout(30000), // 30秒超时
    body: JSON.stringify({
        model: 'tencent-hy-2.0',
        messages: [{ role: 'user', content: '...' }]
    })
});

建议：对于长文本生成，建议使用流式响应（stream=true），避免超时并提升用户体验。

问题表现

AI生成的内容突然中断，缺少结尾部分。

原因分析

通常是max_tokens参数设置过小，导致模型输出被截断。

解决方案

// 增大max_tokens参数
{
    "model": "tencent-hy-2.0",
    "messages": [...],
    "max_tokens": 4096,  // 默认可能只有1024
    "temperature": 0.7
}

提示：不同模型的max_tokens上限不同，请参考官方文档设置合理值。

以下是一个完整的腾讯云大模型API调用示例，包含了错误处理和重试逻辑：

async function callTencentAI(prompt, retries = 3) {
    const apiKey = process.env.TENCENT_API_KEY;
    
    for (let i = 0; i < retries; i++) {
        try {
            const response = await fetch('https://api.example.com/v1/chat', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                    'Authorization': `Bearer ${apiKey}`
                },
                body: JSON.stringify({
                    model: 'tencent-hy-2.0',
                    messages: [{ role: 'user', content: prompt }],
                    max_tokens: 4096,
                    temperature: 0.7
                })
            });
            
            if (!response.ok) {
                throw new Error(`HTTP ${response.status}`);
            }
            
            const data = await response.json();
            return data.choices[0].message.content;
        } catch (error) {
            if (i === retries - 1) throw error;
            // 指数退避重试
            await new Promise(r => setTimeout(r, 1000 * Math.pow(2, i)));
        }
    }
}

如果以上方法无法解决你的问题，可以通过以下渠道获取帮助：

• 查看腾讯云官方文档
• 在腾讯云开发者社区提问
• 联系腾讯云技术支持