AI 模型升级指南

小程序成长计划赠送的混元 Token 当前运行在 hunyuan-exp 提供商下，该提供商将于 2025 年 5 月 30 日下线。下线后，使用 hunyuan-exp 的请求将无法正常调用。

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

---

涉及的模型

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

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

---

升级方式

需要同时做两处改动：

	旧（下线）	新
提供商	hunyuan-exp	hunyuan-v3
模型名称	hunyuan-turbos-latest 等	hy3-preview
Base URL 中的路径	.../hunyuan-exp	.../hunyuan-v3

将 <ENV_ID> 替换为你的云开发环境 ID。

---

各平台改造方式

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

需将 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 支持。