文档首页/ 云桌面 Workspace/ API参考/ 云桌面API/ 模型管理/ 批量新增模型 - BatchCreateModel
更新时间:2026-07-24 GMT+08:00

批量新增模型 - BatchCreateModel

功能介绍

批量创建模型(供应商已存在后追加新增模型)。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    workspace:modelProvider:addModel

    Write

    -

    -

    -

    -

URI

POST /v3/ai-agents/model-providers/{provider_id}/models/batch

表1 路径参数

参数

是否必选

参数类型

描述

provider_id

String

供应商id。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

models

Array of CreateModelReq objects

模型列表。

表3 CreateModelReq

参数

是否必选

参数类型

描述

name

String

模型名称。

input

Array of strings

输入类型数组。

provider_model_id

String

供应商侧模型标识。

description

String

模型描述。

reasoning

Boolean

是否支持推理。

cost

ModelCost object

费用信息。

context_window

Integer

最大上下文窗口。

max_tokens

Integer

最大输出Token数。

compat

ModelCompat object

兼容性配置。

表4 ModelCost

参数

是否必选

参数类型

描述

input

Double

每百万输入Token费用。

output

Double

每百万输出Token费用。

cache_read

Double

每百万缓存读取Token费用。

cache_write

Double

每百万缓存写入Token费用。

表5 ModelCompat

参数

是否必选

参数类型

描述

supports_usage_streaming

Boolean

是否支持使用量流式传输。

supports_developer_role

Boolean

是否支持开发者角色。

响应参数

状态码:200

表6 响应Body参数

参数

参数类型

描述

created_models

Array of ModelItemResp objects

已创建的模型列表。

total

Integer

创建总数。

表7 ModelItemResp

参数

参数类型

描述

id

String

模型id。

name

String

模型名称。

provider_model_id

String

供应商侧模型标识。

input

Array of strings

输入类型数组。

description

String

模型描述。

is_builtin

Boolean

是否为内置模型。

状态码:400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:401

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:403

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

状态码:500

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码,失败时返回。

error_msg

String

错误描述。

请求示例

响应示例

状态码

状态码

描述

200

操作成功。

400

由于包含语法错误,当前请求无法被服务器理解。

401

鉴权失败。

403

没有操作权限。

500

服务内部异常。

错误码

请参见错误码