跳到主要内容

购买 Token 资源包后的模型迁移指南

购买 Token 资源包后，如果业务代码里还在使用旧配置（如 hunyuan-exp/hunyuan-v3 和历史模型名），需要完成一次模型迁移，否则可能出现调用失败或模型不生效。

迁移目标​

完成以下两项替换：

  1. 将提供商从 hunyuan-exp/hunyuan-v3 改为 cloudbase
  2. 将旧模型名改为你在控制台「AI → 生文模型」页面中已启用的模型名

如何确认新模型名​

  1. 打开 云开发控制台
  2. 进入「生文模型」页面
  3. 选择一个已启用的模型（如 hy3-preview、deepseek-v4-flash 等）
  4. 将该模型名填入代码里的 model 字段

代码改造示例​

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

// 改造前
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("cloudbase");

const res = await model.streamText({
  data: {
    model: "hy3-preview", // 替换为生文模型页面已启用的模型
    messages: [{ role: "user", content: "你好" }],
  },
});

Web SDK（@cloudbase/js-sdk）​

// 改造前
const ai = app.ai();

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

const res = await ai.streamText({
  provider: "cloudbase",
  model: "hy3-preview", // 替换为生文模型页面已启用的模型
  messages: [{ role: "user", content: "你好" }],
});

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

// 改造前
const ai = app.ai();

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

const res = await ai.streamText({
  provider: "cloudbase",
  model: "hy3-preview", // 替换为生文模型页面已启用的模型
  messages: [{ role: "user", content: "你好" }],
});

OpenAI SDK（兼容模式）​

// 改造前
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: "你好" }],
});
// 改造后
import OpenAI from "openai";

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

const res = await client.chat.completions.create({
  model: "hy3-preview", // 替换为生文模型页面已启用的模型
  messages: [{ role: "user", content: "你好" }],
});

常见排查​

报错 model cloudbase not found in definitions​

该报错通常表示微信小程序基础库版本过低，不支持 createModel("cloudbase")。

请将小程序基础库升级到 3.15.1 及以上 后再重试。

迁移后仍报模型不可用​

通常是 model 填写了未启用或不存在的模型名。请回到「生文模型」页面确认该模型已启用。

已改为 cloudbase 但仍失败​

请检查是否仍有旧代码路径（例如历史云函数、旧分支或配置中心）仍在使用 hunyuan-exp 或 hunyuan-v3。

相关文档​