@cloudbase/ai 4.0.0 → 4.0.1-alpha.0

package/dist/miniprogram/index.js.LICENSE.txt

@@ -15,8 +15,8 @@ PERFORMANCE OF THIS SOFTWARE.
 
 /**
  * @license
- * web-streams-polyfill v4.0.0
- * Copyright 2024 Mattias Buelens, Diwank Singh Tomer and other contributors.
+ * web-streams-polyfill v4.3.0
+ * Copyright 2026 Mattias Buelens, Diwank Singh Tomer and other contributors.
  * This code is released under the MIT license.
  * SPDX-License-Identifier: MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/ai",
-  "version": "4.0.0",
+  "version": "4.0.1-alpha.0",
   "description": "cloudbase js sdk ai module",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -30,8 +30,8 @@
   "author": "",
   "license": "Apache-2.0",
   "dependencies": {
-    "@cloudbase/types": "4.0.0",
-    "@cloudbase/utilities": "4.0.0",
+    "@cloudbase/types": "4.0.1-alpha.0",
+    "@cloudbase/utilities": "4.0.1-alpha.0",
     "@mattiasbuelens/web-streams-adapter": "^0.1.0",
     "text-encoding-shim": "^1.0.5",
     "web-streams-polyfill": "^4.0.0"
@@ -39,5 +39,5 @@
   "devDependencies": {
     "@cloudbase/adapter-interface": "^0.7.1"
   },
-  "gitHead": "e489e90352537598cac4ce36b64ed3184b0d41b1"
+  "gitHead": "f893174f5888080382b515a0a3ba1f4dd8999662"
 }

package/src/AI.ts

@@ -1,3 +1,5 @@
+/* eslint-disable eqeqeq */
+/* eslint-disable @typescript-eslint/naming-convention */
 import type { SDKRequestInterface } from '@cloudbase/adapter-interface'
 import { Bot } from './bot'
 import * as models from './models'
@@ -9,15 +11,28 @@ import { langEvent } from '@cloudbase/utilities'
 const { MODELS } = models
 
 class AI {
-  public aiBaseUrl: string
-  public aiBotBaseUrl: string
   public bot: Bot
   public i18n: ICloudbaseConfig['i18n']
   defaultHeaders: { [x: string]: any }
+  private _getBaseUrl?: () => string
 
-  constructor(private req: SDKRequestInterface, public baseUrl: string, i18n: ICloudbaseConfig['i18n']) {
-    this.aiBaseUrl = `${baseUrl}/ai`
-    this.aiBotBaseUrl = `${baseUrl}/aibot`
+  /** 动态获取 aiBaseUrl，支持 registerEndPointWithKey 后端点变更生效 */
+  get aiBaseUrl(): string {
+    return `${this._getBaseUrl ? this._getBaseUrl() : this.baseUrl}/ai`
+  }
+
+  /** 动态获取 aiBotBaseUrl，支持 registerEndPointWithKey 后端点变更生效 */
+  get aiBotBaseUrl(): string {
+    return `${this._getBaseUrl ? this._getBaseUrl() : this.baseUrl}/aibot`
+  }
+
+  constructor(
+    private req: SDKRequestInterface,
+    public baseUrl: string,
+    i18n: ICloudbaseConfig['i18n'],
+    getBaseUrl?: () => string,
+  ) {
+    this._getBaseUrl = getBaseUrl
     this.bot = new Bot(this.botRequest, this.aiBotBaseUrl)
     this.i18n = i18n
 
@@ -29,25 +44,42 @@ class AI {
   async handleResponseData(responseData: Promise<unknown> | ReadableStream<Uint8Array>, header?: Headers) {
     const GO_TO_AI_TEXT = `${this.i18n.t('请检查调用方式，或前往云开发 AI+ 首页查看文档')}：https://tcb.cloud.tencent.com/dev#/ai`
 
-    if (typeof responseData === 'object' && responseData && 'then' in responseData) {
-      // 非流式请求，直接返回 json 数据
-      const json = (await responseData) as Record<string, unknown>
-      if (typeof json === 'object' && json && 'code' in json && json.code !== 'NORMAL') {
-        throw new Error(`${this.i18n.t('AI+ 请求出错，错误码')}：${json.code}，${this.i18n.t('错误信息')}：${
-          json.message
+    const throwIfError = (json: unknown) => {
+      if (typeof json === 'object' && json && 'code' in json && (json as any).code !== 'NORMAL') {
+        throw new Error(`${this.i18n.t('AI+ 请求出错，错误码')}：${(json as any).code}，${this.i18n.t('错误信息')}：${
+          (json as any).message
         }\n${GO_TO_AI_TEXT}\n${JSON.stringify(json, null, 2)}`,)
       }
+    }
 
+    // 非流式请求：
+    // - 小程序/Web 适配器返回 Promise（has 'then'）
+    // - Node 适配器已将 body 解析为普通对象（无 'then'、无 getReader）
+    // 两种情况都按 JSON 校验错误码后原样返回
+    if (typeof responseData === 'object' && responseData && typeof (responseData as any).getReader !== 'function') {
+      const json = 'then' in responseData ? await responseData : responseData
+      throwIfError(json)
       return responseData
     }
-    // 流式请求，如果接口出错，会变成传 json 格式的响应，通过 header 判断格式
-    if (header?.get?.('content-type')?.includes('application/json')) {
-      const json = await readableStream2JsonObject(responseData as ReadableStream<Uint8Array>)
+
+    // 判断 responseData 是否是 ReadableStream 实例（兼容 Node.js 适配器非流式场景已解析为 JSON 对象的情况）
+    const isStream = typeof (responseData as any)?.getReader === 'function'
+
+    if (!isStream) {
+      // responseData 已经是解析后的 JSON 对象（如 Node.js 适配器非流式返回），直接检查错误码
+      const json = responseData as unknown as Record<string, unknown>
       if (typeof json === 'object' && json && 'code' in json && json.code !== 'NORMAL') {
         throw new Error(`${this.i18n.t('AI+ 请求出错，错误码')}：${json.code}，${this.i18n.t('错误信息')}：${
           json.message
         }\n${GO_TO_AI_TEXT}\n${JSON.stringify(json, null, 2)}`,)
       }
+      return responseData
+    }
+
+    // 流式请求，如果接口出错，会变成传 json 格式的响应，通过 header 判断格式
+    if (header?.get?.('content-type')?.includes('application/json')) {
+      const json = await readableStream2JsonObject(responseData as ReadableStream<Uint8Array>)
+      throwIfError(json)
     }
     return responseData
   }
@@ -81,6 +113,10 @@ class AI {
     MODELS[name] = model
   }
 
+  createImageModel<T extends 'hunyuan-image' | (string & {})>(provider: T) {
+    return new models.DefaultImageModel<T>(this.modelRequest, this.aiBaseUrl, provider)
+  }
+
   modelRequest: types.ModelReq = async ({ url, data, headers, stream, timeout }) => {
     const fetchHeaders = {
       'Content-Type': 'application/json',
@@ -92,7 +128,7 @@ class AI {
       method: 'post',
       headers: { [this.i18n?.LANG_HEADER_KEY]: this.i18n?.lang, ...fetchHeaders, ...headers },
       body: JSON.stringify(data),
-      url,
+      url: this.resolveUrl(url),
       stream,
       timeout,
     })) as { data: Promise<unknown> | ReadableStream<Uint8Array>; header?: Headers }
@@ -101,8 +137,9 @@ class AI {
   }
 
   botRequest: types.BotReq = async ({ method, url, data = {}, headers, stream, timeout }) => {
+    const resolvedUrl = this.resolveUrl(url)
     if (method === 'get') {
-      return this.handleResponseData((await this.req.fetch({ url: `${url}?${objectToParam(data)}`, method, headers, stream, timeout })).data,)
+      return this.handleResponseData((await this.req.fetch({ url: `${resolvedUrl}?${objectToParam(data)}`, method, headers, stream, timeout })).data,)
     }
 
     const fetchHeaders = {
@@ -112,7 +149,7 @@ class AI {
     stream && Object.assign(fetchHeaders, { Accept: 'text/event-stream' })
 
     const { data: responseData, header } = (await this.req.fetch({
-      url,
+      url: resolvedUrl,
       body: JSON.stringify(data),
       headers: {
         [this.i18n?.LANG_HEADER_KEY]: this.i18n?.lang,
@@ -139,6 +176,16 @@ class AI {
     }
     models.toolMap.set(functionTool.name, functionTool.fn)
   }
+
+  /** 动态替换 URL 中的 origin 部分，支持 registerEndPointWithKey 后生效 */
+  private resolveUrl(url: string): string {
+    if (!this._getBaseUrl) return url
+    const currentBase = this._getBaseUrl()
+    if (currentBase !== this.baseUrl && url.startsWith(this.baseUrl)) {
+      return url.replace(this.baseUrl, currentBase)
+    }
+    return url
+  }
 }
 
 export { AI }

package/src/bot/index.ts

@@ -34,6 +34,7 @@ export class Bot {
   req: BotReq
 
   constructor(req: BotReq, public baseUrl: string) {
+    // eslint-disable-next-line prefer-rest-params
     const token = arguments[2]
     if (typeof token === 'string') {
       this.req = ({ headers = {}, ...rest }) => req({ ...rest, headers: { ...headers, Authorization: `Bearer ${token}` } })
@@ -230,6 +231,7 @@ export class Bot {
 type BotEventStreamData = { content: string }
 
 class StreamResult {
+  // eslint-disable-next-line @typescript-eslint/naming-convention
   private _eventSourceStream: ReadableStream<ParsedEvent>
 
   constructor(_stream: ReadableStream<Uint8Array>) {

package/src/errors.ts

@@ -0,0 +1,23 @@
+/**
+ * 参数校验错误类
+ * 用于统一参数校验错误的格式
+ */
+export class InvalidParamsError extends Error {
+  public code: string
+  public field?: string
+
+  constructor(message: string, field?: string) {
+    super(message)
+    this.name = 'InvalidParamsError'
+    this.code = 'INVALID_PARAMS'
+    this.field = field
+  }
+
+  toJSON() {
+    return {
+      code: this.code,
+      message: this.message,
+      field: this.field,
+    }
+  }
+}

package/src/index.ts

@@ -1,3 +1,4 @@
+/* eslint-disable eqeqeq */
 import type { IFetchOptions, SDKRequestInterface } from '@cloudbase/adapter-interface'
 import type { ICloudbase, ICloudbaseConfig } from '@cloudbase/types'
 import type { ICloudbaseComponent } from '@cloudbase/types/component'
@@ -54,9 +55,11 @@ interface AIInitOption {
   baseUrl?: string
 }
 
-interface ICreateAi {
+interface ICreateAI {
   req: SDKRequestInterface
   baseUrl?: string
+  /** 动态获取 baseUrl 的函数，若提供则优先使用，支持端点变更后请求自动跟随 */
+  getBaseUrl?: () => string
   env?: string
   getAccessToken?: () => Promise<{ accessToken: string }>
   handleReqInstance?: HandleRequestInstanceFunc
@@ -73,8 +76,11 @@ interface ICreateAi {
  *
  * 其他参数可按需传入覆盖函数逻辑。
  */
-function createAi({ env, baseUrl, req, getAccessToken, handleReqInstance, i18n }: ICreateAi) {
+function createAI({ env, baseUrl, getBaseUrl: getBaseUrlFunc, req, getAccessToken, handleReqInstance, i18n }: ICreateAI) {
   const getBaseUrl = () => {
+    if (getBaseUrlFunc != null) {
+      return getBaseUrlFunc()
+    }
     if (baseUrl != null) {
       return baseUrl
     }
@@ -94,13 +100,19 @@ function createAi({ env, baseUrl, req, getAccessToken, handleReqInstance, i18n }
     return handleReqInstance({ req })
   }
 
-  return new AI(getReq(), getBaseUrl(), i18n)
+  return new AI(getReq(), getBaseUrl(), i18n, getBaseUrlFunc)
 }
 
+// 兼容
+/**
+ * @deprecated use `createAI`
+ */
+const createAi = createAI
+
 /**
  * 创建 `AI` 实例。
  * 该函数挂载在 js sdk 的 Cloudbase 实例上。
- * 该函数调用了本模块暴露的 `createAi` 函数，但调用时通过传入参数做了逻辑覆盖：
+ * 该函数调用了本模块暴露的 `createAI` 函数，但调用时通过传入参数做了逻辑覆盖：
  *
  * - 传入从 Cloudbase 实例上的中心的 `req`
  * - 传入从 Cloudbase 实例上拿到的 `baseUrl`
@@ -123,9 +135,12 @@ function ai(
     return `${PROTOCOL}${BASE_URL}`
   }
 
-  const baseUrl = options?.baseUrl ?? getUrlFromCloud()
+  // 若用户传了静态 baseUrl 则使用静态值，否则传入动态获取函数支持端点变更后生效
+  if (options?.baseUrl) {
+    return createAI({ req, baseUrl: options.baseUrl, handleReqInstance: ({ req }) => req, i18n: this.config.i18n })
+  }
 
-  return createAi({ req, baseUrl, handleReqInstance: ({ req }) => req, i18n: this.config.i18n })
+  return createAI({ req, baseUrl: getUrlFromCloud(), getBaseUrl: getUrlFromCloud, handleReqInstance: ({ req }) => req, i18n: this.config.i18n })
 }
 
 const component: ICloudbaseComponent = {
@@ -141,5 +156,10 @@ function registerAi(app: ICloudbase) {
   }
 }
 
-export { AI, Bot, createAi, restModels as models, registerAi, utils }
+export { AI, Bot, createAi, createAI, restModels as models, registerAi, utils }
 export * from './type'
+export * from './errors'
+
+try {
+  (window as any).registerAi = registerAi
+} catch (e) {}

package/src/models/Ark/index.ts

@@ -1,3 +1,5 @@
+/* eslint-disable eqeqeq */
+/* eslint-disable @typescript-eslint/naming-convention */
 import {
   createAsyncIterable,
   TransformStream,

package/src/models/DashScope/index.ts

@@ -1,3 +1,5 @@
+/* eslint-disable eqeqeq */
+/* eslint-disable @typescript-eslint/naming-convention */
 import {
   createAsyncIterable,
   TransformStream,

package/src/models/DeepSeek/index.ts

@@ -1,3 +1,4 @@
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,
@@ -42,6 +43,7 @@ export class DeepSeekSimpleModel implements SimpleChatModel {
 
   public async doStream(data: BaseChatModelInput, options?: ReqOptions): Promise<DoStreamOutput> {
     let isToolCall: null | boolean = null
+    // eslint-disable-next-line @typescript-eslint/naming-convention
     const _stream = await this.req({
       url: this.url,
       data: {

package/src/models/Default/index.ts

@@ -33,6 +33,7 @@ export class DefaultSimpleModel implements SimpleChatModel {
   public async doStream(data: BaseChatModelInput): Promise<DoStreamOutput> {
     let isToolCall: null | boolean = null
 
+    // eslint-disable-next-line @typescript-eslint/naming-convention
     const _stream = await this.req({
       url: this.url,
       data: {
@@ -48,6 +49,7 @@ export class DefaultSimpleModel implements SimpleChatModel {
       transform(chunk, controller) {
         const newChoices = chunk.choices.map((choice) => {
           const message = choice.delta
+          // eslint-disable-next-line eqeqeq
           if (isToolCall == null) isToolCall = isToolCallAssistantMessage(message)
           if (isToolCall) {
             return {

package/src/models/HunYuan/index.ts

@@ -1,3 +1,4 @@
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,
@@ -52,6 +53,7 @@ export class HunYuanSimpleModel implements SimpleChatModel {
   public async doStream(data: BaseChatModelInput, options?: ReqOptions): Promise<DoStreamOutput> {
     let isToolCall: null | boolean = null
 
+    // eslint-disable-next-line @typescript-eslint/naming-convention
     const _stream = await this.req({
       url: this.url,
       headers: {

package/src/models/HunYuan/util.ts

@@ -1,3 +1,5 @@
+/* eslint-disable eqeqeq */
+/* eslint-disable @typescript-eslint/naming-convention */
 import { HunYuanInputData } from './type'
 import { BaseChatModelInput } from '../../type'
 

package/src/models/HunYuanBeta/index.ts

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,

package/src/models/HunYuanExp/index.ts

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,

package/src/models/HunYuanOpen/index.ts

@@ -1,3 +1,4 @@
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,
@@ -45,6 +46,7 @@ export class HunYuanOpenSimpleModel implements SimpleChatModel {
   public async doStream(data: BaseChatModelInput, options?: ReqOptions): Promise<DoStreamOutput> {
     let isToolCall: null | boolean = null
 
+    // eslint-disable-next-line @typescript-eslint/naming-convention
     const _stream = await this.req({
       url: this.url,
       data: {

package/src/models/Moonshot/index.ts

@@ -1,3 +1,4 @@
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,
@@ -17,6 +18,7 @@ import type {
 } from '../../type'
 
 function processInput(input: BaseChatModelInput): MoonshotInputData {
+  // eslint-disable-next-line @typescript-eslint/naming-convention
   const { messages, model, temperature, tools, top_p } = input
 
   return {
@@ -56,6 +58,7 @@ export class MoonshotSimpleModel implements SimpleChatModel {
 
   public async doStream(data: BaseChatModelInput, options?: ReqOptions): Promise<DoStreamOutput> {
     let isToolCall: null | boolean = null
+    // eslint-disable-next-line @typescript-eslint/naming-convention
     const _stream = await this.req({
       url: this.url,
       data: {

package/src/models/Yi/index.ts

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,

package/src/models/ZhiPu/index.ts

@@ -1,3 +1,5 @@
+/* eslint-disable eqeqeq */
+/* eslint-disable @typescript-eslint/naming-convention */
 import {
   createAsyncIterable,
   TransformStream,

package/src/models/image-model.ts

@@ -0,0 +1,100 @@
+import type {
+  ModelReq,
+  // ImageEditInput,
+  HunyuanGenerateImageInput,
+  HunyuanGenerateImageOutput,
+  HunyuanARGenerateImageInput,
+  HunyuanARGenerateImageOutput,
+  // HunyuanEditImageInput,
+  // HunyuanEditImageOutput,
+} from '../type'
+import { InvalidParamsError } from '../errors'
+
+interface HunyuanImageGenerateFn {
+  (input: HunyuanARGenerateImageInput): Promise<HunyuanARGenerateImageOutput>
+  (input: HunyuanGenerateImageInput): Promise<HunyuanGenerateImageOutput>
+}
+
+type GenerateImageFn<TProvider> = TProvider extends 'hunyuan-image'
+  ? HunyuanImageGenerateFn
+  : (input: unknown) => Promise<unknown>
+
+export class DefaultImageModel<TProvider extends string> {
+  public defaultGenerateImageSubUrl = 'images/ar/generations'
+
+  public generateImageSubUrlConfig: Record<string, Array<[RegExp, string]>> = {
+    'hunyuan-image': [
+      [/^hunyuan-image(-v[12](\..*)?)?$/, 'images/generations'],
+    ],
+  }
+
+  /** 生成图片 */
+  public generateImage: GenerateImageFn<TProvider>
+
+  constructor(
+    private req: ModelReq,
+    public baseUrl: string,
+    public provider: TProvider,
+  ) {
+    this.generateImage = this.generateImageImpl.bind(this) as GenerateImageFn<TProvider>
+  }
+
+  /** generateImage 的实际实现 */
+  private async generateImageImpl(input: HunyuanARGenerateImageInput | HunyuanGenerateImageInput,): Promise<HunyuanARGenerateImageOutput | HunyuanGenerateImageOutput> {
+    // 当模型为 HY-Image-v3.0-I2I-ToB-v1.0.1 且 provider 为空或为 hunyuan-image 时校验参数
+    if (
+      typeof input === 'object' && input && 'model' in input && input.model === 'HY-Image-v3.0-I2I-ToB-v1.0.1' && (this.provider === '' || this.provider === 'hunyuan-image')
+    ) {
+      const typedInput = input
+      const imageUrls = typedInput.image_urls as string[] | undefined
+      const images = typedInput.images as string[] | undefined
+
+      if (imageUrls && imageUrls.length > 1) {
+        throw new InvalidParamsError(
+          '当模型为 HY-Image-v3.0-I2I-ToB-v1.0.1 时，image_urls 最多只能有 1 个元素',
+          'image_urls',
+        )
+      }
+      if (images && images.length > 1) {
+        throw new InvalidParamsError(
+          '当模型为 HY-Image-v3.0-I2I-ToB-v1.0.1 时，images 最多只能有 1 个元素',
+          'images',
+        )
+      }
+    }
+
+    let subUrl = this.defaultGenerateImageSubUrl
+
+    if (typeof input === 'object' && input && 'model' in input && typeof input.model === 'string') {
+      const newSubUrl = this.getGenerateImageSubUrl(this.provider, input.model)
+      if (newSubUrl) subUrl = newSubUrl
+    }
+
+    const res = (await this.req({
+      url: this.getGenerateUrl(subUrl),
+      data: input,
+      stream: false,
+    })) as HunyuanARGenerateImageOutput | HunyuanGenerateImageOutput
+
+    return res
+  }
+
+  private getGenerateUrl(subUrl: string) {
+    return `${this.baseUrl}/${this.provider}/${subUrl}`
+  }
+
+  /**
+   * 根据 provider 与 model 解析生成图片的子路径。
+   * 按配置顺序用 RegExp 匹配，命中即返回对应 subUrl。
+   */
+  private getGenerateImageSubUrl(provider: string, model: string): string | undefined {
+    const rules = this.generateImageSubUrlConfig[provider]
+    if (!rules) return undefined
+
+    for (const [pattern, subUrl] of rules) {
+      if (pattern.test(model)) return subUrl
+    }
+
+    return undefined
+  }
+}

package/src/models/index.ts

@@ -9,6 +9,7 @@ import { HunYuanExpSimpleModel } from './HunYuanExp/index'
 import { HunYuanOpenSimpleModel } from './HunYuanOpen/index'
 import { DeepSeekSimpleModel } from './DeepSeek'
 import { DefaultSimpleModel } from './Default'
+import { DefaultImageModel } from './image-model'
 
 export const MODELS = {
   hunyuan: HunYuanSimpleModel,
@@ -34,6 +35,7 @@ export {
   HunYuanExpSimpleModel,
   HunYuanOpenSimpleModel,
   DefaultSimpleModel,
+  DefaultImageModel,
 }
 
 export { ReactModel, toolMap } from './model'

package/src/models/model.ts

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+/* eslint-disable eqeqeq */
 import {
   createAsyncIterable,
   TransformStream,