Training Sets - Upload Data

Referentie

Service:: Azure AI Services

API-versie:: 2024-02-01-preview

Hiermee worden gegevens geüpload naar de opgegeven trainingsset.

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

URI-parameters

Name In Vereist Type Description

Name	In	Vereist	Type	Description
endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	De id van de resource. Regex-patroon: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

endpoint

path

True

string

Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://eastus.api.cognitive.microsoft.com).

path

True

string

De id van de resource.

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

api-version

query

True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagkoptekst

Name Vereist Type Description

Ocp-Apim-Subscription-Key

True

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string	Geef hier uw spraakresourcesleutel op.
Operation-Id		string	Id van de statusmonitor voor de bewerking. Als de Operation-Id-header overeenkomt met een bestaande bewerking en de aanvraag niet identiek is aan de vorige aanvraag, mislukt deze met een 400 Ongeldige aanvraag. Regex-patroon: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Geef hier uw spraakresourcesleutel op.

Operation-Id

string

Id van de statusmonitor voor de bewerking. Als de Operation-Id-header overeenkomt met een bestaande bewerking en de aanvraag niet identiek is aan de vorige aanvraag, mislukt deze met een 400 Ongeldige aanvraag.

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

Aanvraagbody

Name	Vereist	Type	Description
audios	True	AzureBlobContentSource	Azure Blob Storage-inhoud. In de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	Soort gegevensset
description		string	Optionele beschrijving van deze gegevensset.
displayName		string	De naam van deze gegevensset.
scripts		AzureBlobContentSource	Azure Blob Storage-inhoud. In de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Antwoorden

Name	Type	Description
202 Accepted		Geaccepteerd Kopteksten Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Er is een fout opgetreden. Kopteksten x-ms-error-code: string

Name

Type

Description

202 Accepted

Geaccepteerd

Kopteksten

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Er is een fout opgetreden.

Kopteksten

x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

Geef hier uw spraakresourcesleutel op.

Type: apiKey
In: header

Voorbeelden

Upload data to a training set

Voorbeeldaanvraag

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2024-02-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"
    ]
  }
}

Voorbeeldrespons

Statuscode:: 202

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

Definities

Name	Description
AzureBlobContentSource	Azure Blob Storage-inhoud. In de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	Gegevenssetobject
DatasetKind	Soort gegevensset
Error	Fout op het hoogste niveau volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat een fout op het hoogste niveau met foutcode, bericht, details, doel en een interne fout met meer beschrijvende details.
ErrorCode	Foutcode op het hoogste niveau
ErrorResponse	Het antwoord op de fout volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Interne fout volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat de vereiste eigenschappen foutcode, bericht en optionele eigenschappen doel, interne fout (dit kan worden genest).

AzureBlobContentSource

Azure Blob Storage-inhoud. In de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Type	Description
containerUrl	string	Url van Azure Blob Storage-container met SAS. U hebt zowel lees- als lijstmachtigingen nodig.
extensions	string[]	Bestandsnaamextensies.
prefix	string	Blobnaamvoorvoegsel.

Dataset

Gegevenssetobject

Name	Type	Description
audios	AzureBlobContentSource	Azure Blob Storage-inhoud. In de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	Optionele beschrijving van deze gegevensset.
displayName	string	De naam van deze gegevensset.
kind	DatasetKind	Soort gegevensset
scripts	AzureBlobContentSource	Azure Blob Storage-inhoud. In de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Soort gegevensset

Name	Type	Description
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

Fout op het hoogste niveau volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat een fout op het hoogste niveau met foutcode, bericht, details, doel en een interne fout met meer beschrijvende details.

Name	Type	Description
code	ErrorCode	Foutcode op het hoogste niveau
details	Error[]	Aanvullende ondersteunende informatie met betrekking tot de fout en/of het verwachte beleid.
innererror	InnerError	Interne fout volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat de vereiste eigenschappen foutcode, bericht en optionele eigenschappen doel, interne fout (dit kan worden genest).
message	string	Foutbericht op het hoogste niveau.
target	string	De bron van de fout. Dit is bijvoorbeeld 'model' of 'model-id' in het geval van een ongeldig model.

ErrorCode

Foutcode op het hoogste niveau

Name	Type	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Het antwoord op de fout volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Type	Description
error	Error	Fout op het hoogste niveau volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat een fout op het hoogste niveau met foutcode, bericht, details, doel en een interne fout met meer beschrijvende details.

InnerError

Interne fout volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat de vereiste eigenschappen foutcode, bericht en optionele eigenschappen doel, interne fout (dit kan worden genest).

Name	Type	Description
code	string	Gedetailleerde foutcode voor diagnostische gegevens.
innererror	InnerError	Interne fout volgt de Microsoft Azure REST API-richtlijnen die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat de vereiste eigenschappen foutcode, bericht en optionele eigenschappen doel, interne fout (dit kan worden genest).
message	string	Gedetailleerd foutbericht.
target	string	De bron van de fout. Dit is bijvoorbeeld 'model' of 'model-id' in het geval van een ongeldig model.

Delen via

Training Sets - Upload Data

URI-parameters

Aanvraagkoptekst

Aanvraagbody

Antwoorden

Beveiliging

Ocp-Apim-Subscription-Key

Voorbeelden

Upload data to a training set

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

Aanvullende resources