如何使用裁判文书抽取服务_自然语言处理(NLP)-阿里云帮助中心

裁判文书抽取服务API调用出入参帮助文档。

本服务由NLP自学习平台提供，直接调用API即可使用。

重要

为提升算法抽取效果，保证文本抽取中的上下文完整语义，将文本切分优化更新为按断句切分，每个切分段落不超过500个字符数（中文、英文字母、空格、换行都计算字符），如在切分中最后一句文本超出500个字符内，则最后一句文本将切分至下一个段落，每一次切分计一次调用。如有更多疑问，请加自学习平台答疑二群（钉钉群号：44619071）咨询。

服务开通与资源包购买

使用前，请确认是否已经开通服务，开通后可购买资源包。

服务开通：开通地址
购买资源包：购买地址

服务调用与调试

模型调用文档参考：模型调用

SDK示例文档参考：SDK示例

调试

您可以在OpenAPI开发者门户中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI开发者门户可以自动生成SDK代码示例。

通过环境变量配置访问凭证（AKSK）

说明：
1. 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
2. 强烈建议不要把AccessKey和AccessKeySecret保存到代码里，会存在密钥泄露风险，在此提供通过配置环境变量的方式来保存和访问aksk
Linux和macOS系统配置方法
```
export NLP_AK_ENV=<ACCESS_KEY_ID>
export NLP_SK_ENV=<ACCESS_KEY_SECRET>
```
其中<ACCESS_KEY_ID>替换为已准备好的AccessKey ID，<access_key_secret>替换为AccessKey Secret，AccessKey ID和AccessKey Secret的获取方式见步骤二：获取账号的AccessKey
Windows系统配置方法
1. 新建环境变量文件，添加环境变量NLP_AK_ENV和NLP_SK_ENV，并写入已准备好的AccessKey ID和AccessKey Secret。
2. 重启Windows系统。

说明

裁判文书抽取服务，ServiceName需要传入：LegalDocumentExtraction。

Java代码示例

/**
 * 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
 * 此处以把AccessKey和AccessKeySecret保存在环境变量为例说明。您也可以根据业务需要，保存到配置文件里。
 * 强烈建议不要把AccessKey和AccessKeySecret保存到代码里，会存在密钥泄漏风险
 */
String accessKeyId = System.getenv("NLP_AK_ENV");
String accessKeySecret = System.getenv("NLP_SK_ENV");
DefaultProfile defaultProfile = DefaultProfile.getProfile("cn-hangzhou",accessKeyId,accessKeySecret);
IAcsClient client = new DefaultAcsClient(defaultProfile);
String content = "{\"reqId\":\"xxx\",\"cause\":[\"故意伤害罪\"],\"content\":\"文书正文，一定要保留换行符 \\n\",\"services\":[\"normal\",\"liangxing\"]}";
RunPreTrainServiceRequest request = new RunPreTrainServiceRequest();
request.setServiceName("LegalDocumentExtraction");
request.setPredictContent(content);
RunPreTrainServiceResponse response = client.getAcsResponse(request);
System.out.println(response.getPredictResult());

Python代码示例

# 安装依赖
pip install aliyun-python-sdk-core
pip install aliyun-python-sdk-nlp-automl

# -*- coding: utf8 -*-
import json
import os

from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdknlp_automl.request.v20191111 import RunPreTrainServiceRequest

/**
 * 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
 * 此处以把AccessKey和AccessKeySecret保存在环境变量为例说明。您也可以根据业务需要，保存到配置文件里。
 * 强烈建议不要把AccessKey和AccessKeySecret保存到代码里，会存在密钥泄漏风险
 */
access_key_id = os.environ['NLP_AK_ENV']
access_key_secret = os.environ['NLP_SK_ENV']

# Initialize AcsClient instance
client = AcsClient(
  access_key_id,
  access_key_secret,
  "cn-hangzhou"
);

input_params = {
        "reqId": "xxx",
        "cause": ["故意伤害罪"],
        "content": "文书正文",
        "services":["normal","liangxing"], 
}

# Initialize a request and set parameters
request = RunPreTrainServiceRequest.RunPreTrainServiceRequest()
request.set_ServiceName('LegalDocumentExtraction')
request.set_PredictContent(json.dumps(input_params))

# Print response
response = client.do_action_with_exception(request)
resp_obj = json.loads(response)
predict_result = json.loads(resp_obj['PredictResult'])
print(json.dumps(predict_result['data']))

PredictContent内容示例

PredictContent参数为JSON字符串传入，JSON字符串包含内容参考下面举例。

{
  "reqId": "xxx",
  "cause": ["故意伤害罪"],
  "content": "文书正文",
  "services":["normal","liangxing"]
 }

入参说明

参数	说明
reqId	自定义请求ID。
cause	案由。
content	文书正文内容，string
services	选择服务类型。normal：标准字段解析；liangxing：量刑字段解析

说明

1、案由支持多案由，传入JsonArray,不知道传空数组‘[]’。

2、服务类型可以单独解析输出也可以合并解析输出。

3、支持以下10个案由的文书解析，输入的案由如果不在列表中，算法会根据自己判断输出刑事或者民事的通用字段，暂时不支持行政类别的字段。

4、优先使用用户指定的案由名称，只有当输入案由不在支持列表中或者为空时才会使用算法判断案由。

案由枚举值

案由

交通肇事罪

寻衅滋事罪

故意伤害罪

盗窃罪

开设赌场罪

走私、贩卖、运输、制造毒品罪

危险驾驶罪

诈骗罪

民间借贷纠纷

公益诉讼

PredictResult内容示例

参数	说明
reqId	请求id， string，与输入对应
result	结果结构体， json

result结构如下

参数	说明
extract	代表信息抽取内容
laws	代表从文书中抽取的法条内容
segments	代表具体裁判文书分段内容

segments枚举值如下所示

segments

诉讼参与人

法官助理

第三人陈述

原审情况（重审情况）

诉请

反诉

标题

法律效力

原审情况（再审情况）

事实认定

原审情况（一审辩称）

原审情况（反诉辩称）

裁判结果

案号

裁判日期

原审情况（二审判决结果）

反诉辩称

原审情况（一审事实认定）

原审情况（一审第三人陈述）

原审情况（二审诉请）

审理经过

抗诉

被诉行政行为情况

原审情况（一审裁判结果）

法院

原审情况（二审第三人陈述）

其他

辩称

证据段

原审情况（二审辩称）

文书类型

审判人员

原审情况（一审诉请）

原审情况（反诉）

原审情况（二审事实认定）

书记员

附件

原审情况（抗诉情况）

PredictResult是JSON字符串，需要反序列化之后进行解析，具体结构如下示例。

{
    "reqId": "003",
    "result": {
        "extract": {
            "交通肇事罪-是否为逃避法律追究逃离事故现场": "否",
            "交通肇事罪-是否因逃逸致人死亡": "否",
            "交通肇事罪-是否存在肇事逃逸情形": "否",
            "交通肇事罪-是否存在超载情形": "否",
            "交通肇事罪-是否存在酒驾、毒驾情形": "否",
            "交通肇事罪-是否无驾驶资格驾驶": "否",
            "交通肇事罪-是否是代驾": "否",
            "交通肇事罪-是否致人死亡": "是",
            "交通肇事罪-是否致人重伤": "否",
            "交通肇事罪-是否致公私财产遭受重大损失": "否",
            "交通肇事罪-是否获得受害人或家属谅解": "否",
            "交通肇事罪-是否被交通肇事罪或交通肇事罪处置过": "否",
            "交通肇事罪-是否购买保险": "否",
            "交通肇事罪-是否适用非监禁刑罚": "是",
            "交通肇事罪-肇事车辆是否符合国家机动车安全技术标准": "是",
            "交通肇事罪-被告对公诉机关指控是否有异议": "否",
            "交通肇事罪-赔偿受害人或家属金额": [
                "238000元"
            ],
            "交通肇事罪-驾驶人驾驶的是否是校车": "否",
            "刑事通用-公诉机关名称": [
                "河北省高碑店市人民检察院"
            ],
            "刑事通用-判决依据法律条文": [
                "《中华人民共和国刑法》第七十三条第二",
                "《中华人民共和国刑法》第七十二条第一款",
                "《中华人民共和国刑法》第一百三十三条",
                "《中华人民共和国刑法》第六十七条"
            ],
            "刑事通用-判决时间": [
                "2014年10月16日"
            ],
            "刑事通用-制作单位": [
                "河北省高碑店市人民法院"
            ],
            "刑事通用-审判组织": "独任审判",
            "刑事通用-庭审方式": "公开审理",
            "刑事通用-文书名称": [
                "刑事判决书"
            ],
            "刑事通用-文书种类": "判决书",
            "刑事通用-文号": [
                "（2014）高刑初字第1222号"
            ],
            "刑事通用-案件审理阶段": "一审",
            "刑事通用-案发地点": [
                "沿老112国道由北向南行驶至高碑店市高静园公墓路口处"
            ],
            "刑事通用-案发时间": [
                "2013年12月31日7时40分"
            ],
            "刑事通用-被告信息": [
                {
                    "事故责任认定": "主要责任",
                    "刑期": "有期徒刑一年一个月，缓刑二年",
                    "是否为人大代表、政协委员": "否",
                    "是否为民主党派": "否",
                    "是否为涉台人员": "否",
                    "是否为涉外人员": "否",
                    "是否为涉港澳人员": "否",
                    "是否为累犯": "否",
                    "是否有从轻或减轻情节": "是",
                    "是否有从重情节": "否",
                    "是否系主犯": "否",
                    "是否系从犯": "否",
                    "是否系未成年人": "否",
                    "是否系首要分子": "否",
                    "构成罪名": [
                        "交通肇事罪"
                    ],
                    "特殊身份信息": [],
                    "罚金-具体金额": "",
                    "罚金-是否缴清": "",
                    "被告出生日期": "",
                    "被告别名": "",
                    "被告姓名": "刘某",
                    "被告户籍所在地": "",
                    "被告文化水平": "",
                    "被告民族": "",
                    "被告现居住地": "",
                    "被告籍贯": "",
                    "被告职业": "农民",
                    "起诉罪名": [
                        "交通肇事罪"
                    ]
                }
            ],
            "刑事通用-被告触犯法律条文": [],
            "刑事通用-起诉书文号": [
                "高检公诉刑诉（2014）240号"
            ]
        },
        "laws": [
            {
                "lawName": "中华人民共和国刑法",
                "provisionFullName": "中华人民共和国刑法第一百三十三条",
                "provisionID": 133,
                "provisionName": "一百三十三"
            },
            {
                "lawName": "中华人民共和国刑法",
                "provisionFullName": "中华人民共和国刑法第六十七条",
                "provisionID": 67,
                "provisionName": "六十七"
            },
            {
                "lawName": "中华人民共和国刑法",
                "provisionFullName": "中华人民共和国刑法第七十二条第一款",
                "provisionID": 72,
                "provisionName": "七十二"
            },
            {
                "lawName": "中华人民共和国刑法",
                "provisionFullName": "中华人民共和国刑法第七十三条第二",
                "provisionID": 73,
                "provisionName": "七十三"
            }
        ],
        "segments": {
            "书记员": "书记员刘秀坤",
            "事实认定": "另查明，案发后，双方达成协议，由被告人刘某的亲属代其一次性赔偿被害人家人各项经济损失共计人民币238000元。\n上述事实，被告人在开庭审理过程中亦无异议，并有道路交通事故现场图、现场勘验笔录及照片、法医学尸体检验意见书、车辆检验意见书、道路交通事故认定书、机动车驾驶证查询结果、赔偿调解书及收条、被告人的户籍证明等证据证实，足以认定。",
            "审判人员": "审判员刘利刚",
            "审理经过": "高碑店市人民检察院以高检公诉刑诉（2014）240号起诉书指控被告人刘某犯交通肇事罪，向本院提起公诉。本院依法适用简易程序，实行独任审判，公开开庭审理了本案，高碑店市人民检察院检察员张志英、代理检察员翟静出庭支持公诉，被告人刘某到庭参加了诉讼。现已审理终结。",
            "文书类型": "刑事判决书",
            "案号": "（2014）高刑初字第1222号",
            "法律效力": "如不服本判决，可于接到判决书的第二天起十日内，通过本院或者直接向河北省保定市中级人民法院提出上诉。书面上诉的，应提交上诉状正本一份，副本二份。",
            "法院": "河北省高碑店市人民法院",
            "裁判日期": "二〇一四年十月十六日",
            "裁判结果": "本院认为，被告人刘某违反交通运输管理法规，因而发生重大事故致使一人死亡，负事故的主要责任，其行为构成交通肇事罪，公诉机关指控的罪名成立。事故发生后，被告人刘某拨打报警电话，并在现场等待，公安交警人员到达现场后，其如实供述自己罪行，系自首，依法可予以从轻处罚。鉴于被告人刘某认罪悔罪，事发后，其家人代其对被害人的亲属进行了经济赔偿，量刑时亦可酌情从轻处罚并适用缓刑。依照《中华人民共和国刑法》第一百三十三条、第六十七条、第七十二条第一款、第七十三条第二、三款之规定，判决如下：\n被告人刘某犯交通肇事罪，判处有期徒刑一年一个月，缓刑二年。\n（缓刑考验期，自判决确定之日起计算）",
            "诉讼参与人": "公诉机关河北省高碑店市人民检察院。\n被告人刘某，农民。因本案于2014年1月18日被高碑店市公安局刑事拘留，同年1月26日被该局监视居住，7月26日被取保候审。",
            "诉请": "公诉机关指控，2013年12月31日7时40分许，被告人刘某驾驶车牌为冀F×××××号的银灰色捷达轿车，沿老112国道由北向南行驶至高碑店市高静园公墓路口处时，与由西向北转弯上公路的骑行电动自行车的被害人王某相撞，致使王某受伤经抢救无效死亡，两车不同程度损坏。事故发生后，刘某拨打了120急救电话和122报警电话，现场等候交警人员处理事故。经法医鉴定，王某符合交通事故致颅脑损伤合并失血性休克死亡。经高碑店市公安交通警察大队认定，被告人刘某负此事故的主要责任，王某负此事故的次要责任。"
        }
    }
}