先确保获取密钥、选对base_url、构造合法json载荷；登录tokenhub创建api key并立即保存secretkey；在线推理用https://tokenhub.tencentmaas.com/v1/chat/completions；curl命令需替换your_api_key，成功返回含choices[0].message.content的json即可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要用curl快速验证腾讯混元API是否可用，你得先拿到密钥、选对地址、构造合法JSON载荷，三者缺一不可，否则返回401或404就白忙活了。
获取并保存API密钥
登录 TokenHub 控制台 → 进入「API密钥管理」→ 点击「创建API KEY」→ 输入名称（如 hy3-test）→ 确认生成。
生成后【SecretKey 仅首次展示，关闭页面即永久丢失】，务必立即复制粘贴到安全记事本或密码管理器中。
这一步跳过或密钥泄露，后续所有curl命令都会失败。
确认调用入口与模型名
腾讯混元OpenAI兼容接口有三类base_url，按使用场景选其一：
方法一：在线推理（推荐新手验证）
base_url = https://tokenhub.tencentmaas.com/v1
对应完整请求地址：https://tokenhub.tencentmaas.com/v1/chat/completions
方法二：Token Plan（订阅用户）
base_url = https://api.lkeap.cloud.tencent.com/plan/v3
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法三：Anthropic协议（仅限Token Plan且用Claude类工具）
base_url = https://api.lkeap.cloud.tencent.com/plan/anthropic
注意：hy3-preview、hunyuan-turbos-latest等主流模型只支持方法一和方法二，别误配方法三。
执行curl命令发起请求
第一步：打开终端（macOS/Linux用Terminal，Windows用WSL或Git Bash）
第二步：粘贴以下命令，把 YOUR_API_KEY 替换为你刚复制的密钥值：
curl https://tokenhub.tencentmaas.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "model": "hunyuan-turbos-latest", "messages": [{ "role": "user", "content": "你好，请用一句话介绍你自己" }], "enable_enhancement": true }'
第三步：回车执行。若返回JSON中包含 "choices"[0]."message"."content" 字段，且内容为合理中文回复，说明调用成功。
如果报错{"error":{"code":"invalid_api_key"...}}，检查密钥是否拼错、Bearer前是否有空格、引号是否为英文直角引号。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
