腾讯混元OpenAI兼容接口支持无缝切换模型，只需替换base_url和API Key；开通需登录TokenHub控制台领取免费Tokens并创建API Key；提供在线推理、Token Plan及Anthropic三类入口，Python和curl调用示例完整。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元OpenAI兼容接口能让已用OpenAI SDK的项目无缝切换模型，只需替换base_url和API Key，不用改业务代码，适合正在迁移或想快速试用混元大模型的开发者。
开通服务并获取API Key
登录 TokenHub 控制台 https://console.cloud.tencent.com/tokenhub/ → 进入「在线推理」页面 → 选择 Hy3 preview 或其他支持的模型 → 开启「免费体验」和「启用后付费」。
点击右上角「新用户福利免费体验」→ 勾选 Hy3 preview 等模型 → 「立即领取」，获得 50–100 万 Tokens 免费额度，有效期 90 天。
进入「API密钥管理」→ 点击「创建API KEY」→ 编辑名称（如 hy3-dev）→ 确认生成。生成后请立即复制保存，【SecretKey 仅首次展示，之后不可查看】。
配置 base_url 和调用地址
混元 OpenAI 兼容接口有三类入口，按使用场景选择其一：
方法一：在线推理（按量计费）
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
完整请求地址 = https://api.lkeap.cloud.tencent.com/plan/v3/chat/completions
方法三：Anthropic 协议（仅 Token Plan）
base_url = https://api.lkeap.cloud.tencent.com/plan/anthropic
完整请求地址 = https://api.lkeap.cloud.tencent.com/plan/anthropic/v1/messages
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
注意：hy3-preview、DeepSeek-V4-Pro 等 18 款模型均支持方法一和方法二，但不支持方法三；Claude 类工具才需用方法三。
用 Python 调用示例（OpenAI SDK）
第一步：安装官方 OpenAI SDK
pip install openai
第二步：初始化 client 实例
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
base_url="https://tokenhub.tencentmaas.com/v1"
)
第三步：发起对话请求
response = client.chat.completions.create(
model="hy3-preview",
messages=[{"role": "user", "content": "你好，请用中文介绍你自己"}]
)
print(response.choices[0].message.content)
这一步必须用 hy3-preview 或 hy3 作为 model 参数值，其他字符串会导致 404 错误；【model 名称区分大小写，且不可省略】。
用 cURL 直接调试
在终端中执行以下命令（将 YOUR_API_KEY 替换为你的真实 key）：
curl --location 'https://tokenhub.tencentmaas.com/v1/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "hy3-preview",
"messages": [
{"role": "user", "content": "今天天气怎么样？"}
]
}'
如果返回 400 错误且提示 messages 以 user(tool) 提问结束，说明你正在使用 Roo Code、Cursor 等工具——它们默认发送 tool-call 结尾消息，而混元暂不支持该格式，需关闭相关插件或改用 LiteLLM 中转适配。
