三单匹配-模型一键部署接口

一、接口描述

将指定模型版本切换为线上生效模型，请求返回即代表切换完成。校验失败（版本不存在、模型文件损坏）直接在响应中返回错误码。

标注数据导入（标注数据导入接口）
        │  积累人工标注匹配对
        ▼
提交训练任务（训练接口）
        │  训练完成，产出新模型版本 + 评估指标
        ▼
一键部署（模型一键部署接口）
        │  客户选择要上线的版本，拉取模型制品落盘并切换生效版本，主服务与 worker 自动加载
        ▼
线上匹配请求自动使用新模型

输入参数

参数	类型	必填	描述
clientId	string	Y	租户标识
modelVersion	string	Y	要部署的模型版本号

约束：
部署失败时线上自动保持原模型版本不变，不存在部署一半的中间状态。
部署过程线上服务不中断：切换完成前的匹配请求继续使用旧模型。

请求示例：

{
    "clientId": "client_001",
    "modelVersion": "20260803153000"
}

输出参数

输出参数	类型	参数说明
errcode	String	返回码（"0000" 表示部署成功）
description	String	操作信息描述
data	Object	返回结果数据
data.modelVersion	String	本次部署生效的模型版本号
data.previousVersion	String	被替换下线的版本号，首次部署为空
data.deployedAt	String	部署生效时间，`yyyy-MM-dd HH:mm:ss`
traceId	String	请求唯一标识

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "modelVersion": "20260803153000",
        "previousVersion": "20260710093000",
        "deployedAt": "2026-08-03 16:20:35"
    },
    "traceId": "abf23ef9bde547789193e5338b622cad"
}

一、接口描述#

输入参数#

输出参数#

请求参数

请求示例代码

返回响应

一、接口描述

输入参数

输出参数