腾讯元宝网页版免费使用：混元与DeepSeek双模型额度说明

接口形态

腾讯元宝网页版本身不对外提供接口，程序调用走腾讯云混元大模型，它提供 OpenAI 兼容的对话补全地址，base_url 形如 https://api.hunyuan.cloud.tencent.com/v1，完整请求路径为 /chat/completions。如果你的 SDK 要求填 base_url，就填到 /v1 这一层。

模型名与获取途径

常用模型名包括 hunyuan-turbos-latest、hunyuan-standard、hunyuan-pro、hunyuan-lite 等，轻量模型通常有免费调用额度，具体哪些模型免费、免费到什么时候，以控制台模型列表上的标注为准。最稳妥的获取方式是在控制台的模型列表页复制当前账号可用的模型名，不要凭记忆拼写。

配置密钥

先在控制台创建 API 密钥，再写入环境变量，避免把密钥直接写进代码提交到仓库：

export HUNYUAN_API_KEY="控制台创建的密钥"

一次对话补全调用

下面是最小可运行的 curl 示例，请求体为 JSON，messages 按角色组织上下文：

curl https://api.hunyuan.cloud.tencent.com/v1/chat/completions \
  -H "Authorization: Bearer $HUNYUAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hunyuan-turbos-latest",
    "messages": [
      {"role": "system", "content": "你是一名简洁的技术助手"},
      {"role": "user", "content": "用三句话说明什么是大模型接口"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

关键参数说明

• model：必填，取控制台模型列表里的名称，写错会直接返回模型不存在。
• messages：必填，数组，元素包含 role 与 content，role 可取 system、user、assistant。
• temperature：可选，取值 0 到 2 之间，越低输出越稳定，做总结类任务建议 0.2 到 0.5。
• max_tokens：可选，限制单次回复长度，留太小会被截断，留太大在长文场景会更快消耗额度。
• stream：可选，设为 true 时按 SSE 分块返回，适合网页打字机效果。
• top_p：可选，与 temperature 二选一调节即可，同时改动容易让输出难以复现。

额度耗尽与限流的典型表现

• 额度用尽：返回余额不足或资源包耗尽的错误码，正文里常带计费相关字样，此时对话类请求全部失败。
• 触发限流：返回 HTTP 429 或请求频率超限的错误码，表现为短时间连续请求时部分成功、部分失败。
• 鉴权失败：返回 401 或密钥无效提示，通常是密钥被删除、复制时多了空格，或者把网页版的登录状态当成了接口密钥。

排查顺序

1. 先核对 base_url 是否带上了 /v1，以及请求路径是否为 /chat/completions。
2. 再核对 model 名称与控制台列表是否一致，换一个模型重试可快速区分是模型问题还是账号问题。
3. 然后检查请求头里的密钥是否有效、是否被环境变量截断。
4. 接着打开控制台的用量与额度页面，看免费额度是否过期或已耗尽。
5. 最后看并发与频率，把请求改成串行或加退避重试，确认是否只是限流。