Condividi tramite

Training Sets - Create

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

Crea un nuovo set di training.

PUT {endpoint}/customvoice/trainingsets/{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

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

ID della risorsa.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Intestazione della richiesta

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

string

Specificare la chiave della risorsa Voce qui.

Corpo della richiesta

Nome Necessario Tipo Descrizione
locale True

string

Impostazioni locali del set di dati di training. Il codice delle impostazioni locali segue BCP-47. È possibile trovare l'elenco delle impostazioni locali di sintesi vocale qui https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId True

string

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

ID risorsa
description

string

Descrizione del set di training
displayName

string

minLength: 1

Nome del set di training
id

string

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

ID risorsa
status

Status

Stato di una risorsa.
voiceKind

VoiceKind

Tipo voce

Risposte

Nome Tipo Descrizione
201 Created

TrainingSet

Creato
Other Status Codes

ErrorResponse

Si è verificato un errore.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Specificare la chiave della risorsa Voce qui.

Tipo: apiKey
In: header

Esempio

Create a training set

Esempio di richiesta

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


{
  "description": "300 sentences Jessica data in general style.",
  "projectId": "Jessica",
  "locale": "en-US",
  "voiceKind": "Female"
}

Risposta di esempio

Codice di stato:
201 
{
  "id": "Jessica-300",
  "description": "300 sentences Jessica data in general style.",
  "projectId": "Jessica",
  "locale": "en-US",
  "voiceKind": "Female",
  "status": "Succeeded",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Definizioni

Nome Descrizione
Error

L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.
ErrorCode

Codice di errore di primo livello
ErrorResponse

La risposta di errore 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.
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 (che può essere annidato).
Status

Stato di una risorsa.
TrainingSet

Set di training
TrainingSetProperties

Proprietà del set di training
VoiceKind

Tipo voce

Error

Object

L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.

Nome Tipo Descrizione
code

ErrorCode

Codice di errore di primo livello
details

Error[]

Ulteriori dettagli 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 (che può essere annidato).
message

string

Messaggio di errore di primo livello.
target

string

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

ErrorCode

Enumerazione

Codice di errore di primo livello

Valore Descrizione
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Object

La risposta di errore 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.

Nome Tipo Descrizione
error

Error

L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.

InnerError

Object

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 (che 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 (che può essere annidato).
message

string

Messaggio di errore dettagliato.
target

string

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

Status

Enumerazione

Stato di una risorsa.

Valore Descrizione
Disabled
Disabling
Failed
NotStarted
Running
Succeeded

TrainingSet

Object

Set di training

Nome Tipo Descrizione
createdDateTime

string (date-time)

Timestamp di creazione dell'oggetto. Il timestamp viene 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 del set di training
displayName

string

minLength: 1

Nome del set di training
id

string

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

ID risorsa
lastActionDateTime

string (date-time)

Timestamp quando è stato immesso lo stato corrente. Il timestamp viene 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).
locale

string

Impostazioni locali del set di dati di training. Il codice delle impostazioni locali segue BCP-47. È possibile trovare l'elenco delle impostazioni locali di sintesi vocale qui https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId

string

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

ID risorsa
properties

TrainingSetProperties

Proprietà del set di training
status

Status

Stato di una risorsa.
voiceKind

VoiceKind

Tipo voce

TrainingSetProperties

Object

Proprietà del set di training

Nome Tipo Descrizione
utteranceCount

integer (int32)

Conteggio espressioni in questo set di training

VoiceKind

Enumerazione

Tipo voce

Valore Descrizione
Female
Male