Skip to main content

AI Model 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 on May 30, 2025. After the shutdown, any requests using hunyuan-exp will fail.

Please complete the migration before the shutdown date: switch the provider to hunyuan-v3 and update the model name to hy3-preview.

Affected Models​

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

Old Model NameNew Model Name
hunyuan-turbos-latesthy3-preview
hunyuan-t1-latesthy3-preview
hunyuan-2.0-thinking-20251109hy3-preview
hunyuan-2.0-instruct-20251111hy3-preview

Migration Summary​

Two changes are required:

Old (shutting down)New
Providerhunyuan-exphunyuan-v3
Model namehunyuan-turbos-latest etc.hy3-preview
Base URL path.../hunyuan-exp.../hunyuan-v3

Replace <ENV_ID> with your CloudBase environment ID.

Migration Guide by Platform​

Mini Program (wx.cloud.extend.AI)​

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.