发票云（智能特性）
旗舰版标准版智能特性生态版
旗舰版标准版智能特性生态版
  1. 三单匹配
  • 整体介绍
  • 开发指南
  • 授权
    • token获取
      POST
  • 智能特性
    • 文档信息识别
      • 国际发票识别
      • 国际发票识别（明细）
      • 文档信息识别（反馈）
      • 银行回单识别
    • 三单匹配
      • 三单匹配-同步接口
        POST
      • 三单匹配-异步匹配任务提交
        POST
      • 三单匹配-异步匹配结果查询
        POST
      • 三单匹配-异步数据入库
        POST
      • 三单匹配-异步数据入库结果查询
        POST
      • 三单匹配-异步标注数据导入
        POST
      • 三单匹配-异步标注数据导入结果查询
        POST
      • 三单匹配-异步训练接口
        POST
      • 三单匹配-异步训练结果查询
        POST
      • 三单匹配-异步模型一键部署接口
        POST
      • 三单匹配-异步模型一键部署查询接口
        POST
    • 统一反馈
      • 三单匹配反馈详细说明
      • 算法服务统一反馈接口
    • 文档分类（区分发票、附件）
      POST
    • 智能赋码税收分类编码识别
      POST
  • 文档中心
    • 外部文件上传接口
      POST
  • 国际发票
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. 三单匹配

三单匹配-异步训练接口

开发中
POST
/ai/knowledge/nlpService/item/model/train/push

一、接口描述#

基于已导入的人工标注匹配对，异步执行「生成训练样本 → 训练模型 → 评估」全流程，产出一个新的模型版本，但模型版本不会自动生效，需要调用部署接口。提交成功后返回 taskId，通过训练状态查询接口轮询。

二、请求参数#

输入参数#

只有 clientId 必填，其余两个可选参数用于微调，不传就全用服务端默认值。
输入参数类型必填参数说明
clientIdStringY租户标识，最长 64 字符。决定模型归属与取哪个租户的数据，也是「同租户单任务」约束的键
sampleParamsObjectN样本范围与负样本参数，见下
trainParamsObjectN训练超参，见下

sampleParams#

字段类型默认值说明
supplierIdsArray全部限定供应商，不传取该租户全部数据
createdFromString—源记录创建时间下界（含），格式 YYYY-MM-DD HH:MM:SS
createdToString—源记录创建时间上界（不含）
negPerPosInteger4每个发票行最多配几个负样本
useRecallBooleantrue是否用召回式采样产出负样本。降级开关，仅在向量服务不可用时设 false，见「使用限制」

trainParams#

字段类型默认值说明
minRecallNumber0.95阈值选择的 recall 下界约束
betaNumber2.0F-beta 的 beta，>1 偏向 recall
learningRateNumber0.05学习率
nEstimatorsInteger400交叉验证阶段树数上限
约束：
同一 clientId 同一时刻只允许一个进行中的训练任务，重复提交返回错误，错误信息带上在跑任务的 taskId 与 modelVersion。不同 clientId 互不影响。
默认值为服务端配置项取值，部署方改过配置时以实际配置为准。两个对象都只接受上表字段，
传其它键返回 2001 并列出允许的键。
训练耗时与样本量正相关。参考量级：8 万行样本 5 折交叉验证在数十分钟级别；单次执行上限 6 小时，超时任务判失败。训练串行执行，多个任务会排队。

输出参数#

输出参数类型参数说明
errcodeString返回码（"0000" 表示提交成功）
descriptionString操作信息描述
data.taskIdString任务 ID，用 train/query 查结果
data.clientIdString回显租户
data.modelVersionString服务端生成的版本名，训练完成后用它调部署接口
traceIdString请求唯一标识

📌 请求示例#

最简形式 —— 只给 clientId，从初始导入的标注表读取该租户全部数据：
{
    "clientId": "client_001"
}
限定供应商与时间窗、调两个超参：
{
    "clientId": "client_001",
    "sampleParams": {
        "supplierIds": ["S001", "S002"],
        "createdFrom": "2026-01-01 00:00:00",
        "negPerPos": 6
    },
    "trainParams": {
        "learningRate": 0.03,
        "nEstimators": 600
    }
}

请求参数

Query 参数

Header 参数

Body 参数application/json

示例
{
    "clientId": "client_001"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff '/ai/knowledge/nlpService/item/model/train/push?access_token={{access_token}}' \
--header 'client-platform: common' \
--header 'Content-Type: application/json' \
--data '{
    "clientId": "client_001"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "8a99a18a3ca66a8fb332c66130b09f44",
        "clientId": "client_001",
        "modelVersion": "pair_gbdt_v5",
        "reuseSamplesFrom": null
    },
    "traceId": "abf23ef9bde547789193e5338b622cad"
}
修改于 2026-08-21 08:48:21
上一页
三单匹配-异步标注数据导入结果查询
下一页
三单匹配-异步训练结果查询
Built with