Personal Voices - Create

Referenz

Dienst:: Azure AI Services

API-Version:: 2024-02-01-preview

Erstellt eine neue persönliche Stimme mit Audiodateien in Azure Blob Storage.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://eastus.api.cognitive.microsoft.com
id	path	True	string	Die ID der Ressource. RegEx-Muster: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

endpoint

path

True

string

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://eastus.api.cognitive.microsoft.com

path

True

string

Die ID der Ressource.

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

api-version

query

True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung

Ocp-Apim-Subscription-Key

True

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string	Geben Sie hier Ihren Speech-Ressourcenschlüssel an.
Operation-Id		string	ID des Statusmonitors für den Vorgang. Wenn der Operation-Id-Header mit einem vorhandenen Vorgang übereinstimmt und die Anforderung nicht mit der vorherigen Anforderung identisch ist, schlägt er mit einer ungültigen 400-Anforderung fehl. RegEx-Muster: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Geben Sie hier Ihren Speech-Ressourcenschlüssel an.

Operation-Id

string

ID des Statusmonitors für den Vorgang. Wenn der Operation-Id-Header mit einem vorhandenen Vorgang übereinstimmt und die Anforderung nicht mit der vorherigen Anforderung identisch ist, schlägt er mit einer ungültigen 400-Anforderung fehl.

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

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
consentId	True	string	Ressourcen-ID
projectId	True	string	Ressourcen-ID
audios		AzureBlobContentSource	Azure Blob Storage-Inhalt. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description		string	Beschreibung der persönlichen Stimme
displayName		string	Anzeigename der persönlichen Stimme
id		string	Ressourcen-ID
status		Status	Status einer Ressource.

Antworten

Name	Typ	Beschreibung
201 Created	PersonalVoice	Erstellt Header Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Ein Fehler ist aufgetreten. Header x-ms-error-code: string

Name

Typ

Beschreibung

201 Created

PersonalVoice

Erstellt

Header

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Ein Fehler ist aufgetreten.

Header

x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Geben Sie hier Ihren Speech-Ressourcenschlüssel an.

Typ: apiKey
In: header

Beispiele

Create a personal voice

Beispielanforderung

HTTP

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



{
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica/",
    "extensions": [
      ".wav"
    ]
  }
}

Beispiel für eine Antwort

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"
}

Definitionen

Name	Beschreibung
AzureBlobContentSource	Azure Blob Storage-Inhalt. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error	Fehler der obersten Ebene folgen den Microsoft Azure-REST-API-Richtlinien, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler auf oberster Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.
ErrorCode	Fehlercode der obersten Ebene
ErrorResponse	Die Fehlerantwort folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind.
InnerError	Der innere Fehler folgt den Microsoft Azure-REST-API-Richtlinien, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält den erforderlichen Eigenschaftenfehlercode, die Meldung und das optionale Eigenschaftenziel, den inneren Fehler (dieser kann geschachtelt werden).
ModelFailureReason	Fehlerursache des Modelltrainings
PersonalVoice	Persönliches Sprachobjekt
PersonalVoiceProperties	Eigenschaften der persönlichen Stimme
Status	Status einer Ressource.

AzureBlobContentSource

Azure Blob Storage-Inhalt. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Typ	Beschreibung
containerUrl	string	Azure Blob Storage-Container-URL mit SAS. Benötigt sowohl Lese- als auch Listenberechtigungen.
extensions	string[]	Dateinamenerweiterungen.
prefix	string	Präfix des Blobnamens.

Error

Fehler der obersten Ebene folgen den Microsoft Azure-REST-API-Richtlinien, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler auf oberster Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.

Name	Typ	Beschreibung
code	ErrorCode	Fehlercode der obersten Ebene
details	Error[]	Zusätzliche unterstützende Details zum Fehler und/oder zu den erwarteten Richtlinien.
innererror	InnerError	Der innere Fehler folgt den Microsoft Azure-REST-API-Richtlinien, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält den erforderlichen Eigenschaftenfehlercode, die Meldung und das optionale Eigenschaftenziel, den inneren Fehler (dieser kann geschachtelt werden).
message	string	Fehlermeldung der obersten Ebene.
target	string	Die Ursache des Fehlers. Im Falle eines ungültigen Modells wäre es z. B. "Model" oder "Model ID".

ErrorCode

Fehlercode der obersten Ebene

Name	Typ	Beschreibung
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Die Fehlerantwort folgt den Richtlinien der Microsoft Azure-REST-API, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind.

Name	Typ	Beschreibung
error	Error	Fehler der obersten Ebene folgen den Microsoft Azure-REST-API-Richtlinien, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält einen Fehler auf oberster Ebene mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit aussagekräftigeren Details.

InnerError

Der innere Fehler folgt den Microsoft Azure-REST-API-Richtlinien, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält den erforderlichen Eigenschaftenfehlercode, die Meldung und das optionale Eigenschaftenziel, den inneren Fehler (dieser kann geschachtelt werden).

Name	Typ	Beschreibung
code	string	Detaillierter Fehlercode zur Unterstützung der Diagnose.
innererror	InnerError	Der innere Fehler folgt den Microsoft Azure-REST-API-Richtlinien, die unter https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsverfügbar sind. Dies enthält den erforderlichen Eigenschaftenfehlercode, die Meldung und das optionale Eigenschaftenziel, den inneren Fehler (dieser kann geschachtelt werden).
message	string	Ausführliche Fehlermeldung.
target	string	Die Ursache des Fehlers. Im Falle eines ungültigen Modells wäre es z. B. "Model" oder "Model ID".

ModelFailureReason

Fehlerursache des Modelltrainings

Name	Typ	Beschreibung
InaccessibleCustomerStorage	string	Der Kunde verwendet Bring Your Own Storage im Speech-Konto. Auf den Speicher kann jetzt jedoch nicht zugegriffen werden. Bitte lesen Sie die Dokumentation.
Internal	string	Custom Voice Service-Fehler.
SpeakerVerificationFailed	string	Die Zustimmung und das Trainingsaudio stammen nicht vom gleichen Sprecher.
TerminateByUser	string	Der Kunde hat das Modelltraining abgebrochen.

PersonalVoice

Persönliches Sprachobjekt

Name	Typ	Beschreibung
audios	AzureBlobContentSource	Azure Blob Storage-Inhalt. Mit den folgenden Beispielen stellt es Dateien https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId	string	Ressourcen-ID
createdDateTime	string	Der Zeitstempel, bei dem das Objekt erstellt wurde. Der Zeitstempel ist als ISO 8601-Datums- und Uhrzeitformat codiert ("YYYY-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Beschreibung der persönlichen Stimme
displayName	string	Anzeigename der persönlichen Stimme
id	string	Ressourcen-ID
lastActionDateTime	string	Der Zeitstempel, bei dem der aktuelle Status eingegeben wurde. Der Zeitstempel ist als ISO 8601-Datums- und Uhrzeitformat codiert ("YYYY-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
projectId	string	Ressourcen-ID
properties	PersonalVoiceProperties	Eigenschaften der persönlichen Stimme
speakerProfileId	string	Id des persönlichen Sprecherprofils. Füllen Sie diese Eigenschaft in SSML aus.
status	Status	Status einer Ressource.

PersonalVoiceProperties

Eigenschaften der persönlichen Stimme

Name	Typ	Beschreibung
failureReason	ModelFailureReason	Fehlerursache des Modelltrainings

Status

Status einer Ressource.

Name	Typ	Beschreibung
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

Freigeben über

Personal Voices - Create

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

Beispiele

Create a personal voice

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Zusätzliche Ressourcen