Hunyuan LLM Upgrade Guide

The Hunyuan tokens granted by the Mini Program Growth Plan currently run under the hunyuan-exp provider. This provider will be shut down at 00:00 on May 30, 2025.

Please complete the migration before the shutdown date: switch the provider to hunyuan-v3 and update the model name to hy3-preview. If the migration is not completed before the deadline, the system will automatically switch the model to hy3-preview.

After the upgrade, the 100 million tokens granted by the Mini Program Growth Plan can continue to be used with hy3-preview.

More Models

To use models such as DeepSeek, Kimi, MiniMax, or GLM, you can purchase a Token resource package. View documentation

tip

If you have previously modified the Base URL or API Key of the hunyuan-exp provider (i.e., integrated a custom provider), please contact that provider directly for upgrade guidance.

---

Affected Models

The following models are currently hosted under the hunyuan-exp provider and must be migrated:

Old Model Name	New Model Name
hunyuan-turbos-latest	hy3-preview
hunyuan-t1-latest	hy3-preview
hunyuan-2.0-thinking-20251109	hy3-preview
hunyuan-2.0-instruct-20251111	hy3-preview

---

Migration Guide by Platform

Mini Program (wx.cloud.extend.AI)

Version Requirement

WeChat Mini Program base library version 3.15.1 or above is required.

Change the createModel argument from "hunyuan-exp" to "hunyuan-v3", and update the model field to "hy3-preview":

Before:

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: "Hello" }],
  },
});

After:

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

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

---

Web SDK (@cloudbase/js-sdk)

Change the provider from "hunyuan-exp" to "hunyuan-v3", and update model to "hy3-preview":

Before:

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: "Hello" }],
});

After:

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: "Hello" }],
});

---

Node.js SDK (@cloudbase/node-sdk)

Change the provider from "hunyuan-exp" to "hunyuan-v3", and update model to "hy3-preview":

Before:

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: "Hello" }],
});

After:

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: "Hello" }],
});

---

OpenAI SDK (Compatible Mode)

Update the baseURL to replace hunyuan-exp with hunyuan-v3, and update model to "hy3-preview":

Before:

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: "Hello" }],
  stream: true,
});

After:

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: "Hello" }],
  stream: true,
});

Get your API Key from CloudBase Console → Environment → API Key Settings.

---

Getting Help

If you run into issues during migration, visit the CloudBase Community or submit a support ticket for 1-on-1 assistance.