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

一、接口描述

将指定模型版本切换为线上生效模型。提交时同步完成快速校验（参数、版本存在性、无进行中的部署任务），校验失败直接返回错误；校验通过后返回 taskId，部署动作在后台执行，通过部署状态查询接口轮询。

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

输入参数

输入参数	类型	必填	参数说明
action	String	Y	`ACTIVATE` 或 `UNLOAD`，大小写不敏感，前者表示部署模型，后者表示卸载模型
modelVersion	String	Y	模型版本名（同时是产物目录名）
clientId	String	见说明	`ACTIVATE` 必填：把哪个客户的生效版本切到该模型。`UNLOAD` 不接受该参数，传了返回 2001

约束：
ACTIVATE 部署模型是异步任务，UNLOAD 卸载模型是同步任务。
同一 clientId 同一时刻只允许一个进行中的部署任务，重复提交返回错误。
部署失败时线上自动保持原模型版本不变，不存在部署一半的中间状态。
部署过程线上服务不中断：切换完成前的匹配请求继续使用旧模型。

请求示例：

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

输出参数

输出参数	类型	参数说明
errcode	String	返回码（"0000" 表示成功）
description	String	操作信息描述
data	Object	返回结果数据，字段随 action 不同
traceId	String	请求唯一标识

data字段

字段	类型	ACTIVATE	UNLOAD	说明
taskId	String	✓	✓	任务 ID，用 `deploy/query` 查（`UNLOAD` 的任务已是终态）
action	String	✓	✓	回显动作
status	String	`PROCESSING`	`COMPLETED`	`PROCESSING` = 需轮询；`COMPLETED` = 已执行完
clientId	String	✓	`null`	回显客户；`UNLOAD` 不涉及客户，恒 `null`
modelVersion	String	✓	✓	回显版本
syncIntervalS	Integer	默认 60	`null`	各服务实例的同步间隔秒数
note	String	✓	✓	提示信息

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

激活模型卸载模型

{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "9f2c1b7e4a5d43f0b8c6e1a2d3f4b5c6",
        "action": "ACTIVATE",
        "status": "PROCESSING",
        "clientId": "client_001",
        "modelVersion": "pair_gbdt_v5",
        "syncIntervalS": 60,
        "note": "请求已受理，模型加载与切换在后台进行；用 deploy/query 带 taskId 查结果"
    },
    "traceId": "abf23ef9bde547789193e5338b622cad"
}

一、接口描述#

输入参数#

输出参数#