Delen via


Training Sets - Upload Data

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
endpoint
path True

string

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

id
path True

string

minLength: 3
maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

De id van de resource.

api-version
query True

string

minLength: 1

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

Aanvraagkoptekst

Name Vereist Type Description
Ocp-Apim-Subscription-Key True

string

Geef hier uw spraakresourcesleutel op.

Operation-Id

string

minLength: 3
maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

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.

Aanvraagbody

Name Vereist Type Description
audios True

AzureBlobContentSource

Azure Blob Storage-inhoud. Met 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. Met 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

Beveiliging

Ocp-Apim-Subscription-Key

Geef hier uw spraakresourcesleutel op.

Type: apiKey
In: header

Voorbeelden

Upload data to a training set

Voorbeeldaanvraag

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

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. Met 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 Richtlijnen voor Microsoft Azure REST API 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

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

InnerError

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

AzureBlobContentSource

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

Name Type Description
containerUrl

string (url)

Azure Blob Storage-container-URL met SAS-. U hebt zowel lees- als lijstmachtigingen nodig.

extensions

string[]

Bestandsnaamextensies.

prefix

string

Voorvoegsel van blobnaam.

Dataset

Gegevenssetobject

Name Type Description
audios

AzureBlobContentSource

Azure Blob Storage-inhoud. Met 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. Met de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Soort gegevensset

Waarde Description
AudioAndScript
AudioOnly
LongAudio

Error

Fout op het hoogste niveau volgt de Richtlijnen voor Microsoft Azure REST API 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 over de fout en/of het verwachte beleid.

innererror

InnerError

Interne fout volgt richtlijnen voor Microsoft Azure REST API die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat de vereiste eigenschappenfoutcode, bericht en optionele eigenschappendoel, 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

Waarde Description
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Foutreactie volgt richtlijnen voor Microsoft Azure REST API 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 Richtlijnen voor Microsoft Azure REST API 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 richtlijnen voor Microsoft Azure REST API die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat de vereiste eigenschappenfoutcode, bericht en optionele eigenschappendoel, interne fout (dit kan worden genest).

Name Type Description
code

string

Gedetailleerde foutcode voor diagnostische gegevens.

innererror

InnerError

Interne fout volgt richtlijnen voor Microsoft Azure REST API die beschikbaar zijn op https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Dit bevat de vereiste eigenschappenfoutcode, bericht en optionele eigenschappendoel, 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.