腾讯混元API调用教程-人工智能-PHP中文网

国外开发者可用海外手机号和护照5分钟完成腾讯混元api调用：先注册国际站并实名认证，再开通服务创建openai兼容api key，最后用curl或python发起请求，或在lobechat中配置base url和密钥。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

腾讯混元api调用教程 - php中文网

想用腾讯混元大模型跑通第一个API请求，但卡在注册、密钥、配置三连环里？国外开发者不用中国手机号和支付宝，也能5分钟完成从零到调用的全流程。

注册腾讯云国际站并实名认证

打开 https://www.tencentcloud.com，右上角点击 Sign Up，用任意邮箱注册账号。注册时需绑定一个可接收短信的海外手机号（支持美国、加拿大、英国等主流号段），不强制中国大陆号码。

登录后进入控制台 → 账户中心 → 实名认证，上传清晰的护照首页照片。系统自动OCR识别，审核通常2–4个工作日，期间无法创建API Key，【务必提前启动此步骤】。

认证通过后，账户状态变为“已实名”，方可开通混元服务。

开通混元服务并创建 API Key

访问混元控制台地址：https://console.cloud.tencent.com/hunyuan，点击「立即开通服务」按钮。页面跳转后确认服务协议，勾选同意即可开通。

开通成功后，左侧导航栏进入「API Key 管理」→「创建 API Key」。选择「OpenAI 兼容接口」类型，不要选 SDK 方式——后者需要 SecretId/SecretKey 配合签名，而 OpenAI 兼容方式只需一个 sk- 开头的密钥，直接用于 Authorization 头。

点击创建后，页面立即显示完整 API Key。此时必须立刻复制并安全保存，【控制台不再提供二次查看】。密钥泄露将导致账号资源被滥用，不可逆。

用 cURL 发起首次对话请求

方法一：终端直跑（推荐验证）

打开命令行，粘贴以下命令（替换 YOUR_API_KEY 为刚复制的密钥）：

腾讯混元

腾讯混元是由腾讯公司推出的通用大语言模型与AI助手产品，基于自研的混元大模型体系打造，提供智能问答、内容生成、代码辅助、办公写作、知识检索等能力。用户可以通过网页端、移动端等方式使用，用于学习、工作和内容创作等多种场景。

下载

curl https://api.hunyuan.cloud.tencent.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "model": "hunyuan-turbos-latest", "messages": [{ "role": "user", "content": "Hello, are you ready?" }], "enable_enhancement": true }'

若返回 JSON 包含 "choices"[0]."message"."content" 字段且内容为合理回复，说明调用成功。如果报 401 错误，请检查 Authorization 头是否漏了 Bearer 前缀或密钥粘贴不全；报 429 表示并发超限，默认仅允许 5 个会话同时进行。

方法二：用 Python 快速复现（需已安装 openai 库）

执行 pip install --upgrade openai，然后运行：

import os
from openai import OpenAI
client = OpenAI(
  api_key="YOUR_API_KEY",
  base_url="https://api.hunyuan.cloud.tencent.com/v1"
)
response = client.chat.completions.create(
  model="hunyuan-turbos-latest",
  messages=[{"role": "user", "content": "Say this is a test."}]
)
print(response.choices[0].message.content)