Creating a Voice Training Task (Premium Edition)

Updated on 2025-04-22 GMT+08:00

Online Debugging

CLI Examples

View PDF

Function

This API is used to create a voice training task (premium edition). This API returns an OBS URL for uploading voice files.

The voice file is a long audio file in .wav format.
Only voice files can be compressed into a .zip file for upload.

NOTE:

After the files are uploaded, call the API for submitting a voice training task to start review and training.

Calling Method

For details, see Calling APIs.

URI

POST /v1/{project_id}/voice-training-manage/user/advance-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.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	User token. This parameter is mandatory when token authentication is used. You can obtain the token by calling the IAM API used to obtain a user token. Value of X-Subject-Token in the response header.
X-App-UserId	No	String	Third-party user ID, which does not allow Chinese characters.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
tag	No	String	Task tag. ECOMMERCE NEWS MARKETING
description	No	String	Description, which is displayed in the asset library.
sex	No	String	Voice gender, which can be male or female. FEMALE MALE Default value: FEMALE
voice_name	Yes	String	Timbre name. The name is used as the name of the timbre model asset in the asset library.
language	No	String	Training language. Currently, only Chinese is supported. CN: Chinese EN: English Default value: CN
create_type	No	String	Task creation mode. PACKAGE: A .zip file contains all data. SEGMENT: Data is uploaded sentence by sentence.
phone	No	String	Mobile phone number
dhtms_job_id	No	String	Image modeling task ID
batch_name	No	String	Batch Name

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
job_id	String	Task ID.
training_data_uploading_url	String	URL of the uploaded training data. You need to compress the training data into a .zip file and upload the file to this URL. This parameter is specified when create_type is set to package. NOTE: Set content-type to application/zip when uploading files to the OBS URL.
segment_uploading_url	segment_uploading_url object	URL of an upload task sentence by sentence. This parameter is specified when create_type is set to segment.
authorization_letter_uploading_url	String	Upload URL of the authorization letter.

**Table 5** segment_uploading_url
Parameter	Type	Description
audio_uploading_url	Array of strings	URL for uploading audio files. NOTE: Set content-type to audio/wav when uploading files to the OBS URL.
txt_uploading_url	Array of strings	URL for uploading text files. NOTE: Set content-type to text/plain when uploading files to the OBS URL.

Status code: 400

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

Example Requests

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

{
  "tag" : "ECOMMERCE",
  "description" : "It is a female voice.",
  "sex" : "FEMALE",
  "voice_name" : "Gentle female voice",
  "language" : "CN",
  "create_type" : "PACKAGE"
}

Example Responses

Status code: 200

The information is returned when the request succeeded.

{
  "job_id" : "abcdefg",
  "training_data_uploading_url" : "https://my-bucket/data.zip",
  "segment_uploading_url" : {
    "audio_uploading_url" : [ "https://my-bucket/data0.wav" ],
    "txt_uploading_url" : [ "https://my-bucket/data0.txt" ]
  },
  "authorization_letter_uploading_url" : "https://my-bucket/data"
}