Personal Voices - Create

Referentie

Service:: Azure AI Services

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

Hiermee maakt u een nieuwe persoonlijke stem met audiobestanden in Azure Blob Storage.

PUT {endpoint}/customvoice/personalvoices/{id}?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
consentId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resource-id
projectId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resource-id
audios		AzureBlobContentSource	Azure Blob Storage-inhoud. Met de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description		string	Persoonlijke spraakbeschrijving
displayName		string minLength: 1	Weergavenaam van persoonlijke stem
id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resource-id
status		Status	Status van een resource.

Antwoorden

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

Geschapen

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

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

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. Met de onderstaande voorbeelden vertegenwoordigt het bestanden https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
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).
ModelFailureReason	Reden van modeltrainingsfout
PersonalVoice	Persoonlijk spraakobject
PersonalVoiceProperties	Persoonlijke spraakeigenschappen
Status	Status van een resource.

AzureBlobContentSource

Object

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.

Error

Object

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

Inventarisatie

Foutcode op het hoogste niveau

Waarde	Description
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Object

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

Object

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.

ModelFailureReason

Inventarisatie

Reden van modeltrainingsfout

Waarde	Description
InaccessibleCustomerStorage	De klant gebruikt Bring Your Own Storage in spraakaccount. Maar de opslag is nu niet toegankelijk. Raadpleeg doc.
Internal	Custom Voice Service-fout.
SpeakerVerificationFailed	De toestemmings- en trainingsaudio zijn niet afkomstig van dezelfde spreker.
TerminateByUser	De klant heeft modeltraining geannuleerd.

PersonalVoice

Object

Persoonlijk spraakobject

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
consentId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resource-id
createdDateTime	string (date-time)	De tijdstempel waarop het object is gemaakt. De tijdstempel wordt 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 minLength: 1	Weergavenaam van persoonlijke stem
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resource-id
lastActionDateTime	string (date-time)	De tijdstempel waarop de huidige status is ingevoerd. De tijdstempel wordt 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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resource-id
properties	PersonalVoiceProperties	Persoonlijke spraakeigenschappen
speakerProfileId	string (uuid)	Profiel-id van persoonlijke spraakspreker. Vul deze eigenschap in SSML in.
status	Status	Status van een resource.

PersonalVoiceProperties

Object

Persoonlijke spraakeigenschappen

Name	Type	Description
failureReason	ModelFailureReason	Reden van modeltrainingsfout

Status

Inventarisatie

Status van een resource.

Waarde	Description
Disabled
Disabling
Failed
NotStarted
Running
Succeeded

Delen via

Personal Voices - Create

URI-parameters

Aanvraagkoptekst

Aanvraagbody

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