华为云用户手册

响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 参数类型 说明 is_success Boolean 请求是否成功。 computing_resource Object 资源列表集，请参见表3。 error_msg String 请求失败时的错误信息，请求成功时无此字段。 error_code String 请求失败时的错误码，请求成功时无此字段。 表3 computing_resource参数说明 参数名称 参数类型 说明 id String 资源ID，用于区分各个计算资源。 user_id String 用户ID。 project_id String 工程ID。 type String 资源类型，最大长度为10字符，只能由字母，数字，下划线，中划线组成。 driver_memory String 驱动内存，大于等于512M(m)，或大于等于1G(g)。 driver_cores Integer 驱动核数，大于等于1。 executor_memory String 运行内存，大于等于512M(m)，或大于等于1G(g)。 executor_cores Integer 运行核数，大于等于1。 num_executors Integer 核数，大于等于1。

示例 成功响应示例 { "is_success": true, "computing_resource": { "id": "5f0fc90870ef4a678649774f28f9d68e", "user_id": "03cfcb78b4b34ba79c9d5aa43dcfb49a", "project_id": "b09d59c4e8724078a5e8efa65049e78f", "type": "B", "driver_memory": "1024M", "driver_cores": 2, "executor_memory": "2G", "executor_cores": 2, "num_executors": 3 }} 失败响应示例 { "is_success": false, "error_code": "res.1006", "error_msg": "The content for the request is invalid." }

示例 请求示例 { "service_name": "res-subscribe2", "description": "test subscribe service"} 成功响应示例 { "is_success": true, "message": "Succeed to subcribe service." } 失败响应示例 { "is_success": false, "error_code": "res.2301", "error_msg": "Failed to resolve the token from the request." }

示例 请求示例 { "status": "running"} 成功响应示例 { "is_success": true, "message": "Succeed to update service." } 失败响应示例 { "is_success": false, "error_code": "res.2301", "error_msg": "Failed to resolve the token from the request." }

示例 成功响应示例 { "is_success": true, "services": [{ "service_id": "84746641-9af3-4fa6-b6ed-850e1f63416c", "service_name": "res-model-vpc2", "description": "test cusom image", "infer_type": "real-time", "status": "stopped", "is_shared": false, "invocation_times": "0", "failed_times": "0", "publish_time": 1547866687137, "update_time": 1547866687137}]} 失败响应示例 { "is_success": false, "error_code": "res.2301", "error_msg": "Failed to resolve the token from the request." }

响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 is_success 是 Boolean 是否成功。 services 是 List 返回服务列表信息，请参见表3。 表3 services参数说明 参数名称 是否必选 参数类型 说明 service_id 是 String 服务ID。 service_name 是 String 服务名称。 description 否 String 服务描述信息。 infer_type 是 String 服务类型，real-time表示实时服务。 status 是 String 服务状态，deploying、running、stopped、concerning。 is_shared 是 Boolean 是否是共享服务。 invocation_times 是 String 服务总调用次数。 failed_times 是 String 服务失败调用次数。 publish_time 是 Long 服务发布时间。 update_time 是 Long 服务更新时间。

响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 is_success 是 Boolean 是否成功。 service 是 Object 返回服务信息详情，请参见表3。 表3 service参数说明 参数名称 是否必选 参数类型 说明 service_id 是 String 服务ID。 service_name 是 String 服务名称。 description 否 String 服务描述信息。 infer_type 是 String 服务类型，real-time表示实时服务。 status 是 String 服务状态，deploying、running、stopped、concerning。 is_shared 是 Boolean 是否是共享服务。 access_address 是 String 服务推理接口URL。 invocation_times 是 String 服务总调用次数。 failed_times 是 String 服务失败调用次数。 publish_time 是 Long 服务发布时间。 flows 是 List 服务流程信息。 update_time 是 Long 服务更新时间。

示例 请求示例 { "service_name": "res-001", "description": " test cusom image", "service_type": "infer","flows": [ { "feature_uuid": "3e749db6b0974f7f8c383af2c39ecb36", "filter_uuid": "94542021b5014451aae49b09df63783b", "rank_uuid": "17c5b4b89baf4260b5afe90d63115de1", "name": "test1", "rules": [ { "candidate_id": "873da1b6486e450d92e46b944f0526af", "rule_ratio": 50, "priority": "1" }, { "candidate_id": "b54e2c23c9294a48bbac2b520ce1a13b", "rule_ratio": 50, "priority": "1" } ] ,"config":{"model_id": "51f9f632-ee08-4479-a070-252a4f605023","weight": 100,"specification": "c2.m8.g0","instance_count": 1}}] } 成功响应示例 { "is_success": true, "service_id": "70af84f6-98a8-47aa-aa70-a2a9b4366f7d", } 失败响应示例 { "is_success": false, "error_code": "res.1001", "error_msg": "The value of request parameter(service_name) is invalid." }

请求消息 请求参数请参见表2所示。 表2 请求参数说明 参数名称 是否必选 参数类型 说明 service_name 是 String 服务名称，服务名称必须以res-开头，由数字、字母、下划线、中划线组成，不能以中划线结束，最大长度48字符。 service_type 是 String 服务类型，可选值infer, rank, nlp。 description 否 String 服务说明。 flows 是 List 流程列表，请参见表3。 表3 flows参数说明 参数名称 是否必选 参数类型 说明 name 是 String 流程名称，由汉字、数字、字母、下划线、中划线、空格组成，最大长度60字符。 rules 是 List 每个Flow配置不同流量和候选集的规则，请参见表4。 config 是 Object 流程配置信息，请参见表5。 rank_uuid 否 String 排序策略生成的uuid。 feature_uuid 否 String 预处理的离线处理生成的uuid。 filter_uuid 否 String 过滤规则生成的uuid。 表4 rules参数说明 参数名称 是否必选 参数类型 说明 candidate_id 是 String 候选集ID。 rule_ratio 是 Integer 同优先级数据占比（ 0-100 整数 同级别占比和为100）。 priority 是 String 优先级，1-10的整数（1优先级最高），最大长度32。 表5 config参数说明 参数名称 是否必选 参数类型 说明 model_id 是 String 模型ID。 weight 是 Integer ABtest流量占比（0-100 整数 所有流程总和为100）。 specification 是 String 节点规格信息， 目前支持res.vm.cpu.2u。 instance_count 是 Integer 节点实例个数， 最大2个实例。

请求消息 请求参数请参见表2。 表2 请求参数说明 参数名称 是否必选 参数类型 描述信息 type 是 String 资源类型，取值 DLI 、CloudTable。 resource 是 Object resource参数信息如下： type，参数类型String，必选参数，资源类型。 resource_info，参数类型String，必选参数，资源详细信息，JSON字符串。如：undefined: "{\"cluster_name\":\"res_cluster\"}

响应消息 响应参数请参见表3。 表3 响应参数说明 参数名称 参数类型 描述信息 is_success Boolean 请求是否成功。 clusters Object [] clusters包含参数信息如下： id，参数类型String，资源类型。 cluster_name，参数类型String，最大长度为20字符，最小长度为1字符。 status，参数类型String。 is_register，参数类型Boolean。 error_code String 请求失败时的错误码，请求成功时无此字段。 error_msg String 请求失败时的错误信息，请求成功时无此字段。

响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 is_success 是 Boolean 是否成功。 jobs 是 List 请参见表3，返回的作业信息。 total_items 是 Integer 作业总条数。 表3 jobs参数说明 参数名称 是否必选 参数类型 说明 job_id 是 String 训练作业ID。 job_name 是 String 训练作业名称，只能由数字，字母，下划线，中划线组成，最大长度为20字符。 job_description 否 String 训练作业描述，最大长度为256字符。 project_id 是 String 项目编号，用于资源隔离。 user_id 是 String 用户ID。 operating_time 是 Long 操作时间。 request_info 是 Object 请求体。 response_info 是 Object 返回体。 job_status 是 String 作业状态。 resource 是 String 资源，现在支持DLI。 is_use 是 int 是否被使用： 1，被使用。 0，没有被使用。 type 是 String 训练作业类型。

URI GET/v1/{project_id}/jobs?type={type}¤t-page={current-page}&page-size={page-size}&start-time={start-time}&end-time={end-time} 参数说明请参见表1。 表1 URI参数说明 名称 是否必选 类型 说明 project_id 是 String 项目编号，用于资源隔离。获取方法请参见获取项目ID。 type 是 String 查询训练作业的类型retrieval、filter、etl、ranking、nearline、standard、evaluation。 current-page 是 Long 当前页面。 page-size 是 Long 页面条数。 start-time 否 String 开始时间。 end-time 否 String 结束时间。 job-name 否 String 作业名称 job-status 否 String 作业状态 sortby 否 String 排序字段 order 否 String 排序方式：asc,desc workspace_id 否 String 工作空间ID，默认为0

请求消息 请求参数请参见表2所示。 表2 请求参数说明 参数名称 是否必选 参数类型 说明 type 是 String 指标类型。 parameter 是 String 全局配置参数配置。 data_format 否 String 数据格式，用户属性表、物品属性表、用户操作行为表必填，值可以为“csv”和“json”。 data_param 否 JSON data_format为csv时必填，其他可选。 scene_id 是 String 场景ID。 表3 data_param参数说明 参数名称 是否必选 参数类型 说明 header 是 String 是否显示表头。 true：有表头 false：无表头 delimiter 是 String 分隔符，最大长度10字符。 quote 是 String 引用字符，最大长度10字符。 escape 是 String 转义字符，最大长度10字符。

响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 is_success 是 Boolean 是否成功。 job 是 Object 请参见表3，返回的作业信息。 表3 job参数说明 参数名称 是否必选 参数类型 说明 job_id 是 String 训练作业ID。 job_name 是 String 训练作业名称，只能由数字，字母，下划线，中划线组成，最大长度为20字符。 job_description 否 String 训练作业描述，最大长度为256字符。 project_id 是 String 项目编号，用于资源隔离。 user_id 是 String 用户ID。 operating_time 是 Long 操作时间。 request_info 是 Object 请求体。 response_info 是 Object 返回体。 job_status 是 String 作业状态。 resource 是 String 资源，现在支持DLI。 is_use 是 int 是否被使用： 1，被使用。 0，没有被使用。 type 是 String 训练作业类型。

响应消息 响应参数请参见表2-响应参数说明。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 is_success 是 Boolean true表示预测成功，false表示预测失败。 data 是 JSON 请参见表3 data参数说明。 表3 data参数说明 参数名称 是否必选 参数类型 说明 trace_id 是 String 消息追踪ID，标识本次请求的推荐结果。 rec_num 是 Integer 返回的结果数量。 user_id 是 String 用户ID content 是 List 请参见表4，推荐物品的内容。 表4 content参数说明 参数名称 是否必选 参数类型 说明 score 是 Float 物品打分值，值越高推荐越靠前。 item 是 JSON 请参见表5，推荐物品。 表5 item参数说明 参数名称 是否必选 参数类型 说明 id 是 String 推荐物品ID。

示例 请求示例 { "rec_num": 50, "user_id": "260086000000100759", "rank_items": ["00860135010002401", "3101010003401"]} 成功响应示例 { "is_success": true, "data": { "trace_id": "a94495c062c6443b87c097427d99232d", "user_id": "260086000000100759", "rec_num": 2, "content": [ { "score": 0.524979, "item": { "id": "00860135010002401" } }, { "score": 0.524979, "item": { "id": "3101010003401" } } ] }} 失败响应示例 { "is_success": false, "error_msg": "Backend service found error. Failed to respond due to backend service not found or failed to respond, please check the service you request. "}

响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 参数类型 说明 is_success boolean 请求是否成功。 globals object [] 请参见表3，全局配置信息。 error_code String 请求失败时的错误码，请求成功时无此字段。 error_msg String 请求失败时的错误信息，请求成功时无此字段。 表3 globals参数说明 参数名称 参数类型 说明 project_id String 项目编号，用于资源隔离。 user_id String 来自公有云的User ID，用于用户隔离。 type String 指标类型。 parameter String 全局配置参数配置。 data_format String 数据格式，用户属性表、物品属性表，用户操作行为表必填，值可以为“csv”和“json”。 data_param JSON data_format为csv时必填，其他可选。 表4 data_param参数说明 参数名称 是否必选 参数类型 说明 header 是 String 是否显示表头。 true：有表头 false：无表头 delimiter 是 String 分隔符，最大长度10字符。 quote 是 String 引用字符，最大长度10字符。 escape 是 String 转义字符，最大长度10字符。

权限及授权项说明 如果您需要对您所拥有的RES进行精细的权限管理，您可以使用 统一身份认证 服务（Identity and Access Management，简称 IAM ），如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用E CS 服务的其它功能。 默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使用户组中的用户获得相应的权限，这一过程称为授权。授权后，用户就可以基于已有权限对云服务进行操作。 权限根据授权的精细程度，分为角色和策略。角色以服务为粒度，是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作、资源和条件，能够满足企业对权限最小化的安全管控要求。 如果您要允许或是禁止某个接口的操作权限，请使用策略。 账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询云服务器列表，那么这个IAM用户被授予的策略中必须包含允许“ecs:servers:list”的授权项，该接口才能调用成功。

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 对应API接口：自定义策略实际调用的API接口。 授权范围：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。 “√”表示支持，“x”表示暂不支持。 RES的支持自定义策略授权项如下所示： 表1 RES支持的授权项 权限 对应API接口 授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 创建工作空间 POST /v2.0/{project_id}/workspaces res:workspace:add √ √ 查询工作空间详情 GET /v2.0/{project_id}/workspaces/{workspace_id} res:workspace:get √ √ 查询工作空间列表 GET /v2.0/{project_id}/workspaces res:workspace:list √ √ 更新工作空间 PUT /v2.0/{project_id}/workspaces/{workspace_id} res:workspace:modify √ √ 删除工作空间 DELETE /v2.0/{project_id}/workspaces/{workspace_id} res:workspace:delete √ √ 创建数据源 POST /v2.0/{project_id}/workspaces/{workspace_id}/data-sources res:data-source:add √ √ 查询数据源详情 GET /v2.0/{project_id}/workspaces/{workspace_id}/data-sources/{datasource_id} res:data-source:get √ √ 查询数据源列表 GET /v2.0/{project_id}/workspaces/{workspace_id}/data-sources res:data-source:list √ √ 修改数据源内容 PUT /v2.0/{project_id}/workspaces/{workspace_id}/data-sources/{datasource_id} res:data-source:modify √ √ 修改数据源特征 PUT /v2.0/{project_id}/workspaces/{workspace_id}/data-sources/{datasource_id}/data-struct res:data-source:modify √ √ 删除数据源 DELETE /v2.0/{project_id}/workspaces/{workspace_id}/data-sources/{datasource_id} res:data-source:delete √ √ 创建自定义场景 POST /v2.0/{project_id}/workspaces/{workspace_id}/scenes res:scene:add √ √ 创建智能场景 POST /v2.0/{project_id}/workspaces/{workspace_id}/intelligent-scenes res:scene:add √ √ 查询场景详情 GET /v2.0/{project_id}/workspaces/{workspace_id}/scenes/{scene_id} res:scene:get √ √ 查询场景列表 GET /v2.0/{project_id}/workspaces/{workspace_id}/scenes res:scene:list √ √ 更新自定义场景内容 PUT /v2.0/{project_id}/workspaces/{workspace_id}/scenes/{scene_id} res:scene:modify √ √ 更新智能场景内容 PUT /v2.0/{project_id}/workspaces/{workspace_id}/intelligent-scenes/{scene_id} res:scene:modify √ √ 删除场景 DELETE /v2.0/{project_id}/workspaces/{workspace_id}/scenes/{scene_id} res:scene:delete √ √ 新增训练作业 POST /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/job-instance res:job:add √ √ 新增多个训练作业 POST /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/job-instances res:job:add √ √ 查询训练作业 GET /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/job-instance res:job:get √ √ 修改训练作业参数 PUT /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/job-instance/{job_id} res:job:modify √ √ 删除训练作业 DELETE /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/job-instance/{job_id} res:job:delete √ √ 查询训练作业候选集 GET /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/result-set res:job:get √ √ 新建在线服务 POST /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/service-instance res:job:add √ √ 查询在线服务详情 GET /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/service-instance res:job:list √ √ 修改在线服务参数 PUT /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/service-instance/{job_id} res:job:modify √ √ 删除在线服务 DELETE /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/service-instance/{job_id} res:job:delete √ √ 执行作业 POST /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/jobs/{job_id}/schedule-job res:job:run √ √ 执行场景 POST /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/schedule-scene res:scene:run √ √

基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 同样在我的凭证下，您可以查看项目ID。 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见《企业管理服务用户指南》。 父主题： 使用前必读

示例 成功响应示例 { "is_success": true, "message": "Succeed to delete connection resource"} 失败响应示例 { "is_success": false, "error_code": "res.2523", "error_msg": "Get datasource connection information error."}

示例 请求示例 {"text": "在贵州黔东南苗族侗族自治州台江县革一镇乡下，有一座两层的小木屋，和这里的大部分木质吊脚楼一样，小木屋依山而建。但这座木屋又很“特别”，它有一个“山东哥哥助学工作站”的名字。这座木屋，凝聚了“山东哥哥”与贵州山区儿童之间的情谊，也见证了一位名叫隋刚的淄博“80后”小伙18年来的坚守。"} 成功响应示例 {"is_success": true,"flow_id": "b9226bbb0e314a90aaf8dbxxxxxxxxxxx","result": {"loc": "{'台江县', '贵州', '淄博', '山东', '革一镇', '贵州黔东南苗族侗族自治州'}","per": "{'隋刚'}","org": "{'山东哥哥助学工作站'}"}}

示例 成功响应示例 { "is_success": true, "connections": [ { "connection_id": "914ba558-35e1-4fcf-a848-5f193e3b2444", "name": "a", "destination": "cloudtable-res-zk2-rpbIBWT5.cloudtable.com:2181,cloudtable-res-zk3-gqefTdc8.cloudtable.com:2181,cloudtable-res-zk1-3FsKGq9h.cloudtable.com:2181", "state": "FAILED", "cluster_name": "", "service": "CloudTable", "create_time": "1566887641603", "cloudtable_name": "cloudtable-res" } ]} 失败响应示例 { "is_success": false, "error_code": "res.1006", "error_msg": "The content for the request is invalid."}

响应消息 响应参数请参见表2 响应参数说明。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 is_success 是 Boolean 是否成功。 connections 是 List 请参见表3，跨源连接列表。 表3 connections参数说明 参数名称 是否必选 参数类型 说明 id 否 String 标识ID。 cluster_name 是 String 集群名称。 status 否 String 集群状态。 is_register 否 Boolean 是否注册。

示例 成功响应示例 { "is_success": true, "images": [{ "image_id": "xxxxxx", "model_name": "res-default", "model_version": "1.0.0", "type": "infer", "build_time": 1547866687137, "update_time": 1547866687137}]} 失败响应示例 { "is_success": false, "error_code": "res.2301", "error_msg": "Failed to resolve the token from the request." }

响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 is_success 是 Boolean 是否成功。 images 是 List 返回镜像列表信息，请参见表3 images参数说明。 表3 images参数说明 参数名称 是否必选 参数类型 说明 image_id 是 String 镜像ID。 model_name 是 String 镜像名称。 model_version 是 String 镜像版本。 type 是 String 镜像类型。 build_time 是 Long 镜像构建时间。 update_time 是 Long 镜像更新时间。

示例 成功响应示例 { "is_success": true, "message":"Succeed to modify job!"} 失败响应示例 { "is_success": false, "error_code": "res.2301", "error_msg": "Failed to resolve the token from the request."}

功能3 -- 分词 将待处理的文本进行分词处理，将切分后的词集合用空格连接成String并返回。 URL POST 服务部署成功后返回的预测地址 请求消息 请求参数请参见表5 请求参数说明。 表5 请求参数说明 参数名称 是否必选 参数类型 说明 title 是 String 待处理的文本。 mode 是 String 选择功能，该功能指定为"seg"。 响应消息 响应参数请参见表6-响应参数说明。 表6 响应参数说明 参数名称 是否必选 参数类型 说明 result 是 String 一个由分词处理后的词集合生成的字符串，以空格连接。 示例 请求示例 { "mode":"seg", "title":[ "在贵州黔东南苗族侗族自治州台江县革一镇乡下，有一座两层的小木屋，和这里的大部分木质吊脚楼一样，小木屋依山而建。但这座木屋又很“特别”，它有一个“山东哥哥助学工作站”的名字。这座木屋，凝聚了“山东哥哥”与贵州山区儿童之间的情谊，也见证了一位名叫隋刚的淄博“80后”小伙18年来的坚守。", "绝大多数用户的需求往往是关注主流内容和商品。而忽略相对冷门的大量“长尾”信息，导致很多优秀的内容或商品没有机会被用户发现和关注。" ]} 成功响应示例 { "flow_id": "b9226bbb0e314a90aaf8dbxxxxxxxxxxx", "is_success": true, "mode": "seg", "result": [ "在 贵州 黔东南苗族侗族自治州 台江县 革一 镇 乡下 ， 有 一座 两层 的 小木屋 ， 和 这里 的 大部分 木质 吊脚楼 一样 ， 小木屋 依山 而 建 。 但 这 座 木屋 又 很 “ 特别 ” ， 它 有 一个 “ 山东 哥哥 助学 工作站 ” 的 名字 。 这 座 木屋 ， 凝聚 了 “ 山东 哥哥 ” 与 贵州 山区 儿童 之间 的 情谊 ， 也 见证 了 一位 名叫 隋刚 的 淄博 “ 80 后 ” 小伙 18 年来 的 坚守 。", "绝大多数 用户 的 需求 往往 是 关注 主流 内容 和 商品 。 而 忽略 相对 冷门 的 大量 “ 长尾 ” 信息 ， 导致 很多 优秀 的 内容 或 商品 没有 机会 被 用户 发现 和 关注 。" ]}

功能1 -- 关键词提取（未排序） 将待处理的文本进行分词处理并筛选保留关键词。 URL POST 服务部署成功后返回的预测地址。 请求消息 请求参数请参见表1 请求参数说明。 表1 请求参数说明 参数名称 是否必选 参数类型 说明 title 是 String 待处理的文本。 mode 是 String 选择功能，该功能指定为"keywords"。 响应消息 响应参数请参见表2。 表2 响应参数说明 参数名称 是否必选 参数类型 说明 result 是 String 一个由抽取出来的无序的关键词集合生成的字符串，以空格连接。 示例 请求示例 { "mode":"keywords", "title":[ "在贵州黔东南苗族侗族自治州台江县革一镇乡下，有一座两层的小木屋，和这里的大部分木质吊脚楼一样，小木屋依山而建。但这座木屋又很“特别”，它有一个“山东哥哥助学工作站”的名字。这座木屋，凝聚了“山东哥哥”与贵州山区儿童之间的情谊，也见证了一位名叫隋刚的淄博“80后”小伙18年来的坚守。", "绝大多数用户的需求往往是关注主流内容和商品。而忽略相对冷门的大量“长尾”信息，导致很多优秀的内容或商品没有机会被用户发现和关注。" ]} 成功响应示例 { "flow_id": "b9226bbb0e314a90aaf8dbxxxxxxxxxxx", "is_success": true, "mode": "keywords", "result": [ "贵州 黔东南苗族侗族自治州 台江县 两层 小木屋 木质 吊脚楼 依山 木屋 山东 哥哥 助学 工作站 名字 凝聚 山区 儿童 情谊 隋刚 淄博 坚守", "用户 需求 关注 主流 内容 商品 冷门 长尾 信息 优秀 机会" ]}