Querying Voice Training Tasks

Function

Queries voice training tasks.

Calling Method

For details, see Calling APIs.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
offset	No	Integer	Offset where the query starts.
limit	No	Integer	Number of items displayed on each page.
create_until	No	String	Filter the records whose creation time is not later than the entered time.
create_since	No	String	Filter the records whose creation time is not earlier than the entered time.
state	No	String	Task status. By default, all statuses are selected. Multiple statuses can be queried. Use commas (,) to separate them. For example, state=FAILED,WAITING.
job_id	No	String	Task ID.
voice_name	No	String	Voice name.
tag	No	String	Task tag.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-App-UserId	No	String	Third-party user ID, which does not allow Chinese characters.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
count	Integer	Total number of tasks that meet the query criteria.
jobs	Array of TrainingJobInfo objects	Virtual avatar model training tasks.

**Table 5** TrainingJobInfo
Parameter	Type	Description
job_type	String	Training type. LLM_MAJOR: LLM in Chinese and English LLM_MINOR: LLM in Chinese and non-Chinese/English languages BASIC: basic edition (20 sentences) MIDDLE: advanced edition (100 sentences) ADVANCE: premium edition THIRD_PARTY: third-party Mobvoi (training edition)
job_id	String	Task ID.
app_user_id	String	User ID.
voice_name	String	Timbre name. The name is used as the name of the timbre model asset in the asset library.
sex	String	Gender. FEMALE MALE
language	String	Language.
state	String	Task status. CREATING: The task is being created. SYSTEM_AUDITING: The task is being reviewed. AUDITING: The task is being manually reviewed. WAITING: The task is waiting for training. PROCESSING: The task is being trained. RESULT_REVIEW: review result AUDIT_FAILED: The review failed and the system waits for the user to reupload data. FAILED: The task failed. SUCCEED: The task has been completed.
reject_times	Integer	Number of times that the status occurs in the current task.
asset_id	String	ID of the timbre model in the asset library. This parameter is displayed when the task status is successful.
job_failed_code	String	An error code is displayed when a task fails.
job_failed_reason	String	The failure cause is displayed when a task fails.
create_time	Long	Task creation time.
lastupdate_time	Long	Time when the task status is updated.
voice_authorization_url	String	Link to the user's authorization letter.
create_type	String	Task creation mode. PACKAGE: A .zip file contains all data. SEGMENT: Data is uploaded sentence by sentence.
tag	String	Task tag. ECOMMERCE NEWS MARKETING
phone	String	Mobile phone number

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Example Requests

GET https://{endpoint}/v1/3f0924078d1b471c884a5383d4dec9fa/voice-training-manage/user/jobs

Example Responses

Status code: 200

The information is returned when the request succeeded.

{
  "count" : 2147483647,
  "jobs" : [ {
    "job_type" : "BASIC",
    "job_id" : "abcdefg",
    "app_user_id" : "123qwe",
    "voice_name" : "Female voice",
    "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"
  } ]
}