Personal Voices - Post

Referentie

Service:: Azure AI Services

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

Hiermee maakt u een nieuwe persoonlijke stem met audiobestanden in de client.

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

URI-parameters

Name	In	Vereist	Type	Description
projectId	formData	True	string	De project-id. Regex-patroon: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
audioData	formData		file	Audiobestanden.
description	formData		string	Optionele beschrijving van dit model.
displayName	formData		string	De weergavenaam van dit model.
properties	formData		string	Eigenschappen.
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.

Aanvraagkoptekst

Media Types: "multipart/form-data"

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 ongeldige 400-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 ongeldige 400-aanvraag.

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

Antwoorden

Name	Type	Description
201 Created	PersonalVoice	Gemaakt 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

201 Created

PersonalVoice

Gemaakt

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

Create a personal voice

Voorbeeldaanvraag

HTTP

POST {endpoint}/customvoice/personalvoices/Jessica-PersonalVoice?api-version=2024-02-01-preview

Voorbeeldrespons

Statuscode:: 201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1321a2c0-9be4-471d-83bb-bc3be4f96a6f?api-version=2024-02-01-preview
Operation-Id: 1321a2c0-9be4-471d-83bb-bc3be4f96a6f

{
  "id": "Jessica-PersonalVoice",
  "speakerProfileId": "3059912f-a3dc-49e3-bdd0-02e449df1fe3",
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Definities

Name	Description
AzureBlobContentSource	Azure Blob Storage-inhoud. In de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
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	Foutreactie 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).
ModelFailureReason	Reden van fout bij modeltraining
PersonalVoice	Persoonlijk spraakobject
PersonalVoiceProperties	Eigenschappen van persoonlijke spraak
Status	Status van een resource.

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	Azure Blob Storage-container-URL met SAS. U hebt zowel lees- als lijstmachtigingen nodig.
extensions	string[]	Bestandsnaamextensies.
prefix	string	Blobnaamvoorvoegsel.

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

Foutreactie 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.

ModelFailureReason

Reden van fout bij modeltraining

Name	Type	Description
InaccessibleCustomerStorage	string	De klant gebruikt Bring Your Own Storage in Speech Account. Maar de opslag is nu niet toegankelijk. Raadpleeg het document.
Internal	string	Custom Voice Service-fout.
SpeakerVerificationFailed	string	De toestemmings- en trainingsaudio zijn niet afkomstig van dezelfde spreker.
TerminateByUser	string	De klant heeft de modeltraining geannuleerd.

PersonalVoice

Persoonlijk spraakobject

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
consentId	string	Resource-id
createdDateTime	string	De tijdstempel waarop het object is gemaakt. Het tijdstempel is gecodeerd als ISO 8601-datum- en tijdnotatie ('JJJJ-MM-DDThh:mm:ssZ', zie https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Persoonlijke spraakbeschrijving
displayName	string	Weergavenaam van persoonlijke stem
id	string	Resource-id
lastActionDateTime	string	De tijdstempel waarop de huidige status is ingevoerd. Het tijdstempel is gecodeerd als ISO 8601-datum- en tijdnotatie ('JJJJ-MM-DDThh:mm:ssZ', zie https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
projectId	string	Resource-id
properties	PersonalVoiceProperties	Eigenschappen van persoonlijke spraak
speakerProfileId	string	Profiel-id van persoonlijke spraakspreker. Vul deze eigenschap in SSML in.
status	Status	Status van een resource.

PersonalVoiceProperties

Eigenschappen van persoonlijke spraak

Name	Type	Description
failureReason	ModelFailureReason	Reden van fout bij modeltraining

Status

Status van een resource.

Name	Type	Description
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

Delen via

Personal Voices - Post

URI-parameters

Aanvraagkoptekst

Antwoorden

Beveiliging

Ocp-Apim-Subscription-Key

Voorbeelden

Create a personal voice

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Aanvullende resources