文档首页/数字内容生产线 MetaStudio/API参考/声音制作任务管理/查询语音训练任务详情 - ShowVoiceTrainingJob
更新时间：2026-01-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询语音训练任务详情 - ShowVoiceTrainingJob

功能介绍

查询语音训练任务详情

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1/{project_id}/voice-training-manage/user/jobs/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参考获取项目ID。

job_id

是

String

任务id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取。

响应消息头中X-Subject-Token的值。

Authorization

否

String

使用AK/SK方式认证时必选，携带的鉴权信息。

X-Sdk-Date

否

String

使用AK/SK方式认证时必选，请求的发生时间。

格式为(YYYYMMDD'T'HHMMSS'Z')。

X-Project-Id

否

String

使用AK/SK方式认证时必选，携带项目ID信息。

X-App-UserId

否

String

第三方用户ID。不允许输入中文。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

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

表4 VoiceTrainingAllocatedResource

参数

参数类型

描述

resource_id

String

资源ID。

charge_mode

String

资源计费类型。

  • ON_DEMAND:按需计费，目前只有进阶版声音，最多制作三个任务

  • PERIODIC: 包周期

  • ONE_TIME：一次性计费

说明：

  • 一次性计费包括：租户订购的一次性资源，SP管理员分配给租户的一次性资源。

expire_time

String

资源过期时间，格式遵循：RFC 3339 如"2021-01-10T08:43:17Z"

表5 AssessResult

参数

参数类型

描述

speed

AssessProperty object

评估指标详情

sound

AssessProperty object

评估指标详情

snr

AssessProperty object

评估指标详情

reverb

AssessProperty object

评估指标详情

dnsmos_ovrl

AssessProperty object

评估指标详情

dnsmos_bak

AssessProperty object

评估指标详情

suggestion

String

综合建议

表6 AssessProperty

参数

参数类型

描述

expected

String

预期信息

actual

String

实际信息

suggestion

String

中文建议

suggestion_en

String

英文建议

status

Integer

是否超出范围

取值范围：

-1~1

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

GET https://{endpoint}/v1/3f0924078d1b471c884a5383d4dec9fa/voice-training-manage/user/jobs/26f06524-4f75-4b3a-a853-b649a21aaf66

响应示例

状态码：200

处理成功返回。

{
  "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

训练参数异常

错误码

请参见错误码。

父主题： 声音制作任务管理