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

查询语音训练任务列表 - ListVoiceTrainingJob

功能介绍

查询语音训练任务列表

调用方法

请参见如何调用API。

授权信息

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

表2 Query参数

参数

是否必选

参数类型

描述

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

分身数字人模型训练任务列表。

表5 TrainingJobInfo

参数

参数类型

描述

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

表6 VoiceTrainingAllocatedResource

参数

参数类型

描述

resource_id

String

资源ID。

charge_mode

String

资源计费类型。

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

  • PERIODIC: 包周期

  • ONE_TIME：一次性计费

说明：

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

expire_time

String

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

表7 AssessResult

参数

参数类型

描述

speed

AssessProperty object

评估指标详情

sound

AssessProperty object

评估指标详情

snr

AssessProperty object

评估指标详情

reverb

AssessProperty object

评估指标详情

dnsmos_ovrl

AssessProperty object

评估指标详情

dnsmos_bak

AssessProperty object

评估指标详情

suggestion

String

综合建议

表8 AssessProperty

参数

参数类型

描述

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

参数异常。

错误码

请参见错误码。

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