AI 模型管理

AiModelService 围绕 AI 模型分组（AIModelGroup） 进行管理，每个分组包含：

• GroupName：分组名，自定义分组不允许以 cloudbase 为前缀
• BaseUrl：模型服务地址（需为 OpenAI 兼容网关）
• Models：分组下的模型列表（数组，更新时为全量替换）
• Secret：访问模型服务的密钥，支持 SecretId / SecretKey 或 ApiKey
• Status：分组状态，1 开启 / 2 关闭
• Type：分组类型，builtin（云开发内置）/ custom（用户自定义）

初始化​

import CloudBase from '@cloudbase/manager-node'

const app = CloudBase.init({
  secretId: 'Your SecretId',
  secretKey: 'Your SecretKey',
  envId: 'Your envId'
})

const aiModel = app.aiModel

createAIModel​

1. 接口描述​

接口功能：创建一个自定义 AI 模型配置分组。

接口声明：app.aiModel.createAIModel(options): Promise<CreateAIModelResp>

2. 输入参数​

AIModel

AIModelSecret

3. 返回结果​

4. 示例代码​

const res = await app.aiModel.createAIModel({
  groupName: 'custom-deepseek',
  baseUrl: 'https://api.deepseek.com/v1',
  models: [
    { Model: 'deepseek-chat', EnableMCP: false }
  ],
  remark: 'DeepSeek 自定义分组',
  status: 1,
  secret: {
    SecretSource: 'custom',
    ApiKey: 'sk-xxxxxxxxxxxxxxxx'
  }
})

console.log(res.Count, res.RequestId)

updateAIModel​

1. 接口描述​

接口功能：更新已有的 AI 模型配置分组。

接口声明：app.aiModel.updateAIModel(options): Promise<UpdateAIModelResp>

2. 输入参数​

AIModel / AIModelSecret 字段定义同 createAIModel。

3. 返回结果​

4. 示例代码​

const res = await app.aiModel.updateAIModel({
  groupName: 'custom-deepseek',
  models: [
    { Model: 'deepseek-chat', EnableMCP: true },
    { Model: 'deepseek-reasoner', EnableMCP: true }
  ],
  status: 1
})

console.log(res.Count)

deleteAIModel​

1. 接口描述​

接口功能：批量删除 AI 模型配置分组。

接口声明：app.aiModel.deleteAIModel(options): Promise<DeleteAIModelResp>

2. 输入参数​

3. 返回结果​

4. 示例代码​

const res = await app.aiModel.deleteAIModel({
  groupNames: ['custom-deepseek', 'custom-hunyuan']
})

console.log(res.Count)

describeAIModels​

1. 接口描述​

接口功能：查询当前环境下已配置的 AI 模型分组列表（含内置分组与自定义分组）。

接口声明：app.aiModel.describeAIModels(options?): Promise<DescribeAIModelsResp>

2. 输入参数​

3. 返回结果​

AIModelGroup

4. 示例代码​

const res = await app.aiModel.describeAIModels()

for (const group of res.AIModels || []) {
  console.log(group.GroupName, group.Type, group.Status, group.Models?.length)
}

describeManagedAIModelList​

1. 接口描述​

接口功能：查询云开发平台支持的托管类型 AI 模型列表（即由云开发平台统一计费、无需用户自备密钥的模型）。

接口声明：app.aiModel.describeManagedAIModelList(options?): Promise<DescribeManagedAIModelListResp>

2. 输入参数​

3. 返回结果​

ManagedAIModelGroup

ManagedAIModel

ManagedAIModelSpec

ManagedAIModelChargingInfo

4. 示例代码​

const res = await app.aiModel.describeManagedAIModelList()

for (const group of res.ManagedAIModelList || []) {
  console.log(group.GroupName, group.Remark)
  for (const model of group.Models || []) {
    console.log('  -', model.Model, model.ModelSpec?.ContextLength)
  }
}