Training Sets - Upload Data

Referensi

Service:: Azure AI Services

API Version:: 2023-12-01-preview

Mengunggah data ke set pelatihan yang ditentukan.

POST {endpoint}/customvoice/trainingsets/{id}:upload?api-version=2023-12-01-preview

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	ID sumber daya. Regex pattern: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Versi API yang digunakan untuk operasi ini.

endpoint

path

True

string

Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://eastus.api.cognitive.microsoft.com).

path

True

string

ID sumber daya.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

api-version

query

True

string

Versi API yang digunakan untuk operasi ini.

Header Permintaan

Nama Diperlukan Jenis Deskripsi

Ocp-Apim-Subscription-Key

True

Nama	Diperlukan	Jenis	Deskripsi
Ocp-Apim-Subscription-Key	True	string	Berikan kunci sumber daya Ucapan Anda di sini.
Operation-Id		string	ID monitor status untuk operasi. Jika header Operation-Id cocok dengan operasi yang ada dan permintaan tidak identik dengan permintaan sebelumnya, itu akan gagal dengan 400 Permintaan Buruk. Regex pattern: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Berikan kunci sumber daya Ucapan Anda di sini.

Operation-Id

string

ID monitor status untuk operasi. Jika header Operation-Id cocok dengan operasi yang ada dan permintaan tidak identik dengan permintaan sebelumnya, itu akan gagal dengan 400 Permintaan Buruk.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
audios	True	AzureBlobContentSource	Azure Blob Storage konten. Dengan contoh di bawah ini, ini mewakili file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	Jenis himpunan data
description		string	Deskripsi opsional dari himpunan data ini.
displayName		string	Nama himpunan data ini.
scripts		AzureBlobContentSource	Azure Blob Storage konten. Dengan contoh di bawah ini, ini mewakili file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Respons

Nama	Jenis	Deskripsi
202 Accepted		Diterima Headers Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Terjadi kesalahan.

Nama

Jenis

Deskripsi

202 Accepted

Diterima

Headers

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Terjadi kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Berikan kunci sumber daya Ucapan Anda di sini.

Type: apiKey
In: header

Contoh

Upload data to a training set

Sample Request

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2023-12-01-preview



{
  "kind": "AudioAndScript",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".wav"
    ]
  },
  "scripts": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".txt"
    ]
  }
}

Sample Response

Status code:: 202

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2023-12-01-preview
Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345

Definisi

Nama	Deskripsi
AzureBlobContentSource	Azure Blob Storage konten. Dengan contoh di bawah ini, ini mewakili file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	Objek himpunan data
DatasetKind	Jenis himpunan data
Error	Kesalahan tingkat atas mengikuti Panduan REST API Microsoft Azure yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Ini berisi kesalahan tingkat atas dengan kode kesalahan, pesan, detail, target, dan kesalahan dalam dengan detail yang lebih deskriptif.
ErrorCode	Kode kesalahan tingkat atas
ErrorResponse	Respons kesalahan mengikuti Panduan MICROSOFT Azure REST API yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Kesalahan dalam mengikuti Panduan REST API Microsoft Azure yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Ini berisi kode kesalahan properti yang diperlukan, pesan, dan target properti opsional, kesalahan dalam (ini dapat ditumpuk).

AzureBlobContentSource

Azure Blob Storage konten. Dengan contoh di bawah ini, ini mewakili file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nama	Jenis	Deskripsi
containerUrl	string	Azure Blob Storage URL kontainer dengan SAS. Perlu izin baca dan daftar.
extensions	string[]	Ekstensi nama file.
prefix	string	Awalan nama blob.

Dataset

Objek himpunan data

Nama	Jenis	Deskripsi
audios	AzureBlobContentSource	Azure Blob Storage konten. Dengan contoh di bawah ini, ini mewakili file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	Deskripsi opsional dari himpunan data ini.
displayName	string	Nama himpunan data ini.
kind	DatasetKind	Jenis himpunan data
scripts	AzureBlobContentSource	Azure Blob Storage konten. Dengan contoh di bawah ini, ini mewakili file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Jenis himpunan data

Nama	Jenis	Deskripsi
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

Kesalahan tingkat atas mengikuti Panduan REST API Microsoft Azure yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Ini berisi kesalahan tingkat atas dengan kode kesalahan, pesan, detail, target, dan kesalahan dalam dengan detail yang lebih deskriptif.

Nama	Jenis	Deskripsi
code	ErrorCode	Kode kesalahan tingkat atas
details	Error[]	Detail dukungan tambahan mengenai kesalahan dan/atau kebijakan yang diharapkan.
innererror	InnerError	Kesalahan dalam mengikuti Panduan REST API Microsoft Azure yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Ini berisi kode kesalahan properti yang diperlukan, pesan, dan target properti opsional, kesalahan dalam (ini dapat ditumpuk).
message	string	Pesan kesalahan tingkat atas.
target	string	Sumber kesalahan. Misalnya itu akan menjadi "model" atau "id model" jika model tidak valid.

ErrorCode

Kode kesalahan tingkat atas

Nama	Jenis	Deskripsi
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Respons kesalahan mengikuti Panduan MICROSOFT Azure REST API yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nama	Jenis	Deskripsi
error	Error	Kesalahan tingkat atas mengikuti Panduan REST API Microsoft Azure yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Ini berisi kesalahan tingkat atas dengan kode kesalahan, pesan, detail, target, dan kesalahan dalam dengan detail yang lebih deskriptif.

InnerError

Kesalahan dalam mengikuti Panduan REST API Microsoft Azure yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Ini berisi kode kesalahan properti yang diperlukan, pesan, dan target properti opsional, kesalahan dalam (ini dapat ditumpuk).

Nama	Jenis	Deskripsi
code	string	Kode kesalahan terperinci untuk membantu diagnostik.
innererror	InnerError	Kesalahan dalam mengikuti Panduan REST API Microsoft Azure yang tersedia di https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Ini berisi kode kesalahan properti yang diperlukan, pesan, dan target properti opsional, kesalahan dalam (ini dapat ditumpuk).
message	string	Pesan kesalahan terperinci.
target	string	Sumber kesalahan. Misalnya itu akan menjadi "model" atau "id model" jika model tidak valid.

Bagikan melalui

Training Sets - Upload Data

Parameter URI

Header Permintaan

Isi Permintaan

Respons

Keamanan

Ocp-Apim-Subscription-Key

Contoh

Upload data to a training set

Sample Request

Sample Response

Definisi

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

Sumber Daya Tambahan: