Help Center/ MetaStudio/ API Reference/ Voice Modeling Task Management/ Obtaining the URL for Uploading a Voice File
Updated on 2024-07-04 GMT+08:00

Obtaining the URL for Uploading a Voice File

Function

Obtains the URL for uploading a voice file.

Calling Method

For details, see Calling APIs.

URI

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

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.

job_id

Yes

String

Task ID.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

segment_url

segment_url object

URL of an upload task by sentence.

package_url

package_url object

URL for uploading an entire package.

authorization_letter_uploading_url

String

Upload URL of the authorization letter.

Table 3 segment_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.

Table 4 package_url

Parameter

Type

Description

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.

NOTE:
  • Set content-type to application/zip when uploading files to the OBS URL.

Status code: 400

Table 5 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/26f06524-4f75-4b3a-a853-b649a21aaf66/uploading-address-url

Example Responses

Status code: 200

The information is returned when the request succeeded.

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

Status Codes

Status Code

Description

200

The information is returned when the request succeeded.

400

Training exception.

Error Codes

See Error Codes.