# 查询语音训练任务列表 - ListVoiceTrainingJob #### 功能介绍 查询语音训练任务列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-metastudio/metastudio_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-metastudio/metastudio_02_0071.html)。 #### URI GET /v1/{project_id}/voice-training-manage/user/jobs 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID，获取方法请参考[获取项目ID](https://support.huaweicloud.com/api-metastudio/metastudio_02_0006.html)。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 否 | Integer | 偏移量，表示从此偏移量开始查询。 **取值范围：** 0\~2147483647 **默认取值：** 0 | | limit | 否 | Integer | 每页显示的条目数量。 **取值范围：** 1\~100 **默认取值：** 10 | | create_until | 否 | String | 过滤创建时间\<=输入时间的记录。 | | create_since | 否 | String | 过滤创建时间\>=输入时间的记录。 | | update_until | 否 | String | 过滤更新时间\<=输入时间的记录。 | | update_since | 否 | String | 过滤更新时间\>=输入时间的记录。 | | state | 否 | String | 任务状态，默认所有状态。 可多个状态查询，使用英文逗号分隔。 如state=FAILED,WAITING 任务状态包括： \* CREATING: 创建中 \* SYSTEM_AUDITING: 系统审核中 \* AUDITING: 人工审核中 \* WAITING_SPLIT: 等待切割 \* SPLITTING: 切割中 \* SPLIT_FAILED: 切割失败 \* ANNOTATING: 标注中 \* WAITING: 等待训练 \* PROCESSING: 任务训练中 \* RESULT_REVIEW: 审核结果 \* AUDIT_FAILED: 审核失败,等待用户重传数据 \* UPLOADING: 上传中 \* FAILED: 失败 \* SUCCEED: 成功 | | job_id | 否 | String | 任务id。 | | voice_name | 否 | String | 声音名称。 | | tag | 否 | String | 任务标签。 | | job_type | 否 | String | 训练类型。 - BASIC: 基础版(20句话) - MIDDLE: 进阶版(100句话) - ADVANCE: 高级版 - THIRD_PARTY: 第三方出门问问训练版 - THIRD_PARTY_LJZN: 第三方逻辑智能训练版 - FLEXUS: Flexus版---用的是大模型特征提取 | | batch_name | 否 | String | 批次名称。 | | sort_key | 否 | String | 排序字段，当前支持：ceate_time/update_time **默认取值：** create_time | | sort_dir | 否 | String | 排序规则：desc(降序)/asc(升序) **默认取值：** desc | | is_ondemand_resource | 否 | Boolean | 是否是按需任务 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-App-UserId | 否 | String | 第三方用户ID。不允许输入中文。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | count | Integer | 满足查询要求的任务总数。 **取值范围：** 0\~2147483647 | | jobs | Array of [TrainingJobInfo] objects | 分身数字人模型训练任务列表。 | 表5TrainingJobInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | job_type | String | 训练类型。 - BASIC: 基础版(20句话) - MIDDLE: 进阶版(100句话) - ADVANCE: 高级版 - THIRD_PARTY: 第三方出门问问训练版 - THIRD_PARTY_LJZN: 第三方逻辑智能训练版 - FLEXUS: Flexus版---用的是大模型特征提取 | | job_id | String | 任务id。 | | app_user_id | String | 用户id。 | | voice_name | String | 音色名称。该名称会作为资产库中音色模型资产名称。 | | sex | String | 性别。 - FEMALE: 女性 - MALE: 是男性 | | language | String | 语言。 | | state | String | 任务状态。 - CREATING: 创建中 - SYSTEM_AUDITING: 系统审核中 - AUDITING: 人工审核中 - WAITING_SPLIT: 等待切割 - SPLITTING: 切割中 - SPLIT_FAILED: 切割失败 - ANNOTATING: 标注中 - WAITING: 等待训练 - PROCESSING: 任务训练中 - RESULT_REVIEW: 审核结果 - AUDIT_FAILED: 审核失败,等待用户重传数据 - UPLOADING: 上传中 - FAILED: 失败 - SUCCEED: 成功 | | reject_times | Integer | 本次任务中该状态出现的次数 **取值范围：** 1\~10 | | asset_id | String | 当任务状态为成功时呈现,音色模型在资产库中的id。 | | job_failed_code | String | 当任务失败时呈现,失败错误码。 | | job_failed_reason | String | 当任务失败时呈现,失败原因。 | | create_time | Long | 任务创建时间。 **取值范围：** 1\~2147483647 | | lastupdate_time | Long | 任务状态更新时间。 **取值范围：** 1\~2147483647 | | voice_authorization_url | String | 用户授权书连接。 | | training_input_source_url | String | 用户原始输入数据url。 | | create_type | String | 任务创建方式。 - PACKAGE: 使用一个zip包包含所有数据 - SEGMENT: 逐句上传数据 | | tag | String | 任务标签。 - ECOMMERCE: 电商 - NEWS: 新闻 - MARKETING: 营销 - LIVE: 直播 - EDUCATION: 教培 - CUSTOMER: 客服 - STORYTELLING: 故事 | | phone | String | 手机号 | | dhtms_job_id | String | 形象制作任务id | | batch_name | String | 批次名称 | | allocated_resource | [VoiceTrainingAllocatedResource] object | | | output_language | String | 模型输出语言类型 | | is_remake | Boolean | 任务是否重做 | | assess_result | [AssessResult] object | 音频质量评估结果 | | is_ondemand_resource | Boolean | 是否是按需任务 **默认取值：** false | 表6VoiceTrainingAllocatedResource | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resource_id | String | 资源ID。 | | charge_mode | String | 资源计费类型。 - ON_DEMAND:按需计费，目前只有进阶版声音，最多制作三个任务 - PERIODIC: 包周期 - ONE_TIME：一次性计费 说明： - 一次性计费包括：租户订购的一次性资源，SP管理员分配给租户的一次性资源。 | | expire_time | String | 资源过期时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z" | 表7AssessResult | 参数 | 参数类型 | 描述 | |:---|:---|:---| | speed | [AssessProperty] object | 评估指标详情 | | sound | [AssessProperty] object | 评估指标详情 | | snr | [AssessProperty] object | 评估指标详情 | | reverb | [AssessProperty] object | 评估指标详情 | | dnsmos_ovrl | [AssessProperty] object | 评估指标详情 | | dnsmos_bak | [AssessProperty] object | 评估指标详情 | | suggestion | String | 综合建议 | 表8AssessProperty | 参数 | 参数类型 | 描述 | |:---|:---|:---| | expected | String | 预期信息 | | actual | String | 实际信息 | | suggestion | String | 中文建议 | | suggestion_en | String | 英文建议 | | status | Integer | 是否超出范围 **取值范围：** -1\~1 | **状态码：400** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | #### 请求示例 ``` GET https://{endpoint}/v1/3f0924078d1b471c884a5383d4dec9fa/voice-training-manage/user/jobs ``` #### 响应示例 **状态码：200** 处理成功返回。 ``` { "count" : 2147483647, "jobs" : [ { "job_type" : "BASIC", "job_id" : "abcdefg", "app_user_id" : "123qwe", "voice_name" : "女声", "sex" : "FEMALE", "language" : "CN", "state" : "WAITING", "asset_id" : "my_asset_id", "job_failed_code" : "MSS.00000000", "job_failed_reason" : "error reason", "create_time" : 2147483647, "lastupdate_time" : 2147483647, "voice_authorization_url" : "https://bucket/data", "create_type" : "PACKAGE", "tag" : "ECOMMERCE" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 处理成功返回。 | | 400 | 参数异常。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-metastudio/ErrorCode.html)。