Condividi tramite

Personal Voices - Create

  • Riferimento
Servizio:
Azure AI Services
Versione API:
2024-02-01-preview

Crea una nuova voce personale con file audio in Archiviazione BLOB di Azure.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpoint
 path True

string

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://eastus.api.cognitive.microsoft.com).
id
 path True

string

ID della risorsa.

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version
 query True

string

Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Ocp-Apim-Subscription-Key True

string

Specificare qui la chiave della risorsa Voce.
Operation-Id

string

ID del monitoraggio dello stato per l'operazione. Se l'intestazione Operation-Id corrisponde a un'operazione esistente e la richiesta non è identica alla richiesta precedente, avrà esito negativo con una richiesta non valida 400.

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Corpo della richiesta

Nome Necessario Tipo Descrizione
consentId True

string

ID risorsa
projectId True

string

ID risorsa
audios

AzureBlobContentSource

Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description

string

Descrizione vocale personale
displayName

string

Nome visualizzato della voce personale
id

string

ID risorsa
status

Status

Stato di una risorsa.

Risposte

Nome Tipo Descrizione
201 Created

PersonalVoice

Data di creazione

Intestazioni

  • Operation-Id: string
  • Operation-Location: string
Other Status Codes

ErrorResponse

Si è verificato un errore.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Specificare qui la chiave della risorsa Voce.

Tipo: apiKey
In: header

Esempio

Create a personal voice

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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"
}

Definizioni

Nome Descrizione
AzureBlobContentSource

Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error

L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.
ErrorCode

Codice di errore di primo livello
ErrorResponse

La risposta agli errori segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).
ModelFailureReason

Motivo dell'errore di training del modello
PersonalVoice

Oggetto voce personale
PersonalVoiceProperties

Proprietà vocali personali
Status

Stato di una risorsa.

AzureBlobContentSource

Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nome Tipo Descrizione
containerUrl

string

URL del contenitore di Archiviazione BLOB di Azure con firma di accesso condiviso. Sono necessarie autorizzazioni sia di lettura che di elenco.
extensions

string[]

Estensioni del nome file.
prefix

string

Prefisso del nome DEL BLOB.

Error

L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.

Nome Tipo Descrizione
code

ErrorCode

Codice di errore di primo livello
details

Error[]

Dettagli aggiuntivi di supporto relativi all'errore e/o ai criteri previsti.
innererror

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).
message

string

Messaggio di errore di primo livello.
target

string

Indica l'origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

ErrorCode

Codice di errore di primo livello

Nome Tipo Descrizione
BadArgument

string

BadRequest

string

Forbidden

string

InternalServerError

string

NotFound

string

ServiceUnavailable

string

TooManyRequests

string

Unauthorized

string

UnsupportedMediaType

string

ErrorResponse

La risposta agli errori segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome Tipo Descrizione
error

Error

L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).

Nome Tipo Descrizione
code

string

Codice di errore dettagliato per facilitare la diagnostica.
innererror

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).
message

string

Messaggio di errore dettagliato.
target

string

Indica l'origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

ModelFailureReason

Motivo dell'errore di training del modello

Nome Tipo Descrizione
InaccessibleCustomerStorage

string

Il cliente usa Bring Your Own Storage nell'account voce. Ma lo spazio di archiviazione non è ora accessibile. Controllare la documentazione.
Internal

string

Errore del servizio vocale personalizzato.
SpeakerVerificationFailed

string

Il consenso e l'audio di training non provengono dallo stesso altoparlante.
TerminateByUser

string

Il cliente ha annullato il training del modello.

PersonalVoice

Oggetto voce personale

Nome Tipo Descrizione
audios

AzureBlobContentSource

Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId

string

ID risorsa
createdDateTime

string

Timestamp al momento della creazione dell'oggetto. Il timestamp è codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description

string

Descrizione vocale personale
displayName

string

Nome visualizzato della voce personale
id

string

ID risorsa
lastActionDateTime

string

Timestamp in cui è stato immesso lo stato corrente. Il timestamp è codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
projectId

string

ID risorsa
properties

PersonalVoiceProperties

Proprietà vocali personali
speakerProfileId

string

ID profilo voce personale. Compilare questa proprietà in SSML.
status

Status

Stato di una risorsa.

PersonalVoiceProperties

Proprietà vocali personali

Nome Tipo Descrizione
failureReason

ModelFailureReason

Motivo dell'errore di training del modello

Status

Stato di una risorsa.

Nome Tipo Descrizione
Disabled

string

Disabling

string

Failed

string

NotStarted

string

Running

string

Succeeded

string