创建模型配置

创建供智能体引用的模型配置。该接口不上传或保存提供商密钥。

POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/model-configs

调用前准备

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

引用的连接、凭据等资源必须有效；接口本身不接收提供商密钥。

请求体

curl -X POST "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/model-configs" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "销售分析模型",
    "model_name": "<MODEL_NAME>",
    "model_category": "chat"
  }'

字段

类型

必填

说明

workspace_id

string

是

当前工作区 ID，必须与 X-Workspace-ID 一致。

字段

类型

必填

说明

name

string

是

配置名称。

model_name

string

是

模型名称。

description

string

否

配置说明。

status

string

否

配置状态。

source_kind

string

否

模型来源类型。

model_category

string

否

模型类别。

provider_ref

string

否

提供商引用。

display_name

string

否

配置的显示名称。

connection_ref

string

否

已存在的连接资源引用。

credential_ref

string

否

已存在的凭据引用。

capabilities

array of string

否

模型能力。

limits

object

否

模型使用限制。

pricing_ref

string

否

定价配置引用。

labels

object

否

标签键值对。

annotations

object

否

注解键值对。

metadata

object

否

扩展元数据。

成功响应

成功时返回 201。data 为新模型配置。

{
  "code": 0,
  "data": {
    "id": "mc_01",
    "workspace_id": "ws_01",
    "name": "销售分析模型",
    "status": "active",
    "source_kind": "workspace",
    "model_category": "chat",
    "model_name": "<MODEL_NAME>",
    "version": 1,
    "created_at": "2026-08-18T01:00:00Z",
    "updated_at": "2026-08-18T01:00:00Z"
  }
}

字段

类型

说明

code

integer

成功时为 0。

字段

类型

说明

data.id

string

模型配置 ID。

data.workspace_id

string

所属工作区 ID。

data.name

string

配置名称。

data.source_kind

string

模型来源类型。

data.model_name

string

模型名称。

data.model_category

string

模型类别。

字段

类型

说明

data.status

string

配置状态。

字段

类型

说明

data.version

integer

配置版本。

data.created_at

string

创建和更新时间。

data.updated_at

string

创建和更新时间。

错误响应

{
  "code": 2,
  "message": "模型配置参数无效"
}

字段

类型

说明

code

integer

错误代码。

message

string

面向调用者的错误信息。

后续操作

保存 data.id，再在智能体模型绑定中引用该配置。

最后更新于