跳到主要内容

混元大模型升级指南

小程序成长计划赠送的混元 Token 当前运行在 hunyuan-exp 提供商下，该提供商将于 2025 年 5 月 30 日 0 点下线。

请在下线前完成升级，将提供商切换到 hunyuan-v3，同时将模型名称更换为 hy3-preview。如到期未完成切换，系统将自动将模型切换到 hy3-preview。

升级后，小程序成长计划赠送的一亿 Token 可继续在 hy3-preview 上使用。

更多模型

如需使用 DeepSeek、Kimi、MiniMax、GLM 等更多模型，可通过购买 Token 资源包来开通，点击查看文档。

提示

如果您之前修改过 hunyuan-exp 提供商的 Base URL 或 API Key（即接入了自定义的提供商），升级操作请直接联系对应的提供商进行咨询。

涉及的模型​

以下模型目前位于 hunyuan-exp 提供商下，需要升级：

旧模型名称新模型名称
hunyuan-turbos-latesthy3-preview
hunyuan-t1-latesthy3-preview
hunyuan-2.0-thinking-20251109hy3-preview
hunyuan-2.0-instruct-20251111hy3-preview

各平台改造方式​

小程序（wx.cloud.extend.AI）​

版本要求

需要微信小程序基础库版本 3.15.1 及以上。

需将 createModel 的参数由 "hunyuan-exp" 改为 "hunyuan-v3"，同时将 model 字段改为 "hy3-preview"：

改造前：

const model = wx.cloud.extend.AI.createModel("hunyuan-exp");

const res = await model.streamText({
  data: {
    model: "hunyuan-2.0-instruct-20251111",
    messages: [{ role: "user", content: "你好" }],
  },
});

改造后：

const model = wx.cloud.extend.AI.createModel("hunyuan-v3");

const res = await model.streamText({
  data: {
    model: "hy3-preview",
    messages: [{ role: "user", content: "你好" }],
  },
});

Web SDK（@cloudbase/js-sdk）​

需将 provider 字段由 "hunyuan-exp" 改为 "hunyuan-v3"，同时将 model 改为 "hy3-preview"：

改造前：

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({ env: "<ENV_ID>" });
const ai = app.ai();

const res = await ai.streamText({
  provider: "hunyuan-exp",
  model: "hunyuan-2.0-instruct-20251111",
  messages: [{ role: "user", content: "你好" }],
});

改造后：

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({ env: "<ENV_ID>" });
const ai = app.ai();

const res = await ai.streamText({
  provider: "hunyuan-v3",
  model: "hy3-preview",
  messages: [{ role: "user", content: "你好" }],
});

Node.js SDK（@cloudbase/node-sdk）​

需将 provider 字段由 "hunyuan-exp" 改为 "hunyuan-v3"，同时将 model 改为 "hy3-preview"：

改造前：

const cloudbase = require("@cloudbase/node-sdk");

const app = cloudbase.init({ env: "<ENV_ID>" });
const ai = app.ai();

const res = await ai.streamText({
  provider: "hunyuan-exp",
  model: "hunyuan-2.0-instruct-20251111",
  messages: [{ role: "user", content: "你好" }],
});

改造后：

const cloudbase = require("@cloudbase/node-sdk");

const app = cloudbase.init({ env: "<ENV_ID>" });
const ai = app.ai();

const res = await ai.streamText({
  provider: "hunyuan-v3",
  model: "hy3-preview",
  messages: [{ role: "user", content: "你好" }],
});

OpenAI SDK（兼容模式）​

需将 baseURL 中的 hunyuan-exp 替换为 hunyuan-v3，同时将 model 改为 "hy3-preview"：

改造前：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "<YOUR_API_KEY>",
  baseURL: "https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/hunyuan-exp",
});

const res = await client.chat.completions.create({
  model: "hunyuan-2.0-instruct-20251111",
  messages: [{ role: "user", content: "你好" }],
  stream: true,
});

改造后：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "<YOUR_API_KEY>",
  baseURL: "https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/hunyuan-v3",
});

const res = await client.chat.completions.create({
  model: "hy3-preview",
  messages: [{ role: "user", content: "你好" }],
  stream: true,
});

API Key 在 云开发控制台 → 环境管理 → API Key 配置 中获取。

获取帮助​

如升级过程中遇到问题，可前往 云开发社区 提问，或提交工单获取 1v1 支持。