模型接入 / 腾讯混元 Hunyuan

腾讯混元 Hunyuan 模型接入

所有模型系列共用同一套 OpenAI 兼容接入流程；切换后只需关注当前模型提示。

OpenAI 兼容

切换模型系列：腾讯混元

Qwen DeepSeek GLM Kimi MiniMax 腾讯混元

通用接入信息橙域 API Key · OpenAI Base URL · Model ID

查看环境变量配置 →

01 查询模型 ID

模型清单由当前 API Key 的分组授权决定，先执行 GET /v1/models：

GET /v1/models

curl "${XELFORA_OPENAI_BASE_URL}/models" \
  -H "Authorization: Bearer ${XELFORA_API_KEY}"

只复制返回结果中的准确 id 并保存为 XELFORA_MODEL。没有对应条目时，请联系管理员，不要猜型号。

02 发送第一次调用

把返回的模型 ID 保存为 XELFORA_MODEL，再选择语言复制示例。

curl "${XELFORA_OPENAI_BASE_URL}/chat/completions" \
  -H "Authorization: Bearer ${XELFORA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "${XELFORA_MODEL}",
  "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己。"}],
  "stream": false
}'

普通文本使用 POST /v1/chat/completions。流式、工具调用、视觉和推理能力请按实际 Model ID 单独验证。

腾讯混元 Hunyuan 使用提示

面向腾讯混元模型类别的统一网关入口；只有查询结果中出现对应 ID 时才表示当前 Key 可以调用。

该类别不代表所有账号已开通。
具体型号、认证和地域要求需要按交付与实际查询结果确认。

遇到 401、403、429 或模型不可用？查看通用错误处理 →