Models - Create

  • Reference
Služba:
Azure AI Services
Verze rozhraní API:
2024-02-01-preview

Vytvoří nový hlasový model.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string

Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://eastus.api.cognitive.microsoft.com).
id
 path True

string

ID prostředku.

Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version
 query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name Vyžadováno Typ Description
Ocp-Apim-Subscription-Key True

string

Tady zadejte svůj klíč prostředku služby Speech.
Operation-Id

string

ID monitorování stavu operace Pokud hlavička Operation-Id odpovídá existující operaci a požadavek není shodný s předchozím požadavkem, selže s chybnou žádostí 400.

Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Text požadavku

Name Vyžadováno Typ Description
consentId True

string

ID prostředku
projectId True

string

ID prostředku
recipe True

Recipe

Recept na vytváření modelů Různé recepty mají různé možnosti.
trainingSetId True

string

ID prostředku
description

string

Popis modelu
id

string

ID prostředku
locale

string

Národní prostředí tohoto modelu. Kód národního prostředí se řídí BCP-47. Seznam národního prostředí pro převod textu na řeč najdete tady https://video2.skills-academy.com/azure/ai-services/speech-service/language-support?tabs=tts.
properties

ModelProperties

Vlastnosti modelu
status

Status

Stav prostředku.
voiceName

string

Hlasové jméno

Odpovědi

Name Typ Description
201 Created

Model

Vytvořeno

Hlavičky

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

ErrorResponse

Došlo k chybě.

Hlavičky

x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tady zadejte svůj klíč prostředku služby Speech.

Typ: apiKey
V: header

Příklady

Create a model
Create a multi style model

Create a model

Ukázkový požadavek

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



{
  "voiceName": "JessicaNeural",
  "description": "Jessica voice",
  "recipe": {
    "kind": "Default"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300"
}

Ukázková odpověď

Stavový kód:
201 
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1f4352df-f247-40c0-a7b1-a54d017933e1?api-version=2024-02-01-preview
Operation-Id: 1f4352df-f247-40c0-a7b1-a54d017933e1
{
  "id": "Jessica",
  "voiceName": "JessicaNeural",
  "description": "Jessica voice",
  "recipe": {
    "kind": "Default",
    "version": "V7.2023.03"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "engineVersion": "2023.07.04.0",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Create a multi style model

Ukázkový požadavek

PUT {endpoint}/customvoice/models/JessicaMultiStyle?api-version=2024-02-01-preview



{
  "voiceName": "JessicaMultiStyleNeural",
  "description": "Jessica multi style voice",
  "recipe": {
    "kind": "MultiStyle"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "properties": {
    "presetStyles": [
      "cheerful",
      "sad"
    ],
    "styleTrainingSetIds": {
      "happy": "JessicaHappy-300",
      "myStyle2": "JessicaStyle2"
    }
  }
}

Ukázková odpověď

Stavový kód:
201 
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/a01a127a-c204-4e46-a8c1-fab01559b05b?api-version=2024-02-01-preview
Operation-Id: a01a127a-c204-4e46-a8c1-fab01559b05b
{
  "id": "JessicaMultiStyle",
  "voiceName": "JessicaMultiStyleNeural",
  "description": "Jessica multi style voice",
  "recipe": {
    "kind": "MultiStyle",
    "version": "V3.2023.06"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "engineVersion": "2023.07.04.0",
  "properties": {
    "presetStyles": [
      "cheerful",
      "sad"
    ],
    "styleTrainingSetIds": {
      "happy": "JessicaHappy-300",
      "myStyle2": "JessicaStyle2"
    },
    "voiceStyles": [
      "cheerful",
      "sad",
      "happy",
      "myStyle2"
    ]
  },
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Definice

Name Description
Error

Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.
ErrorCode

Kód chyby nejvyšší úrovně
ErrorResponse

Odpověď na chybu se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError

Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a cíl volitelných vlastností, vnitřní chybu (může být vnořená).
Model

Objekt modelu
ModelFailureReason

Důvod selhání trénování modelu
ModelProperties

Vlastnosti modelu
PresetStyleItem

Přednastavené styly podporované v receptu Hlasový model může tyto styly podporovat bez jakékoli sady trénování stylu.
Recipe

Recept na vytváření modelů Různé recepty mají různé možnosti.
Status

Stav prostředku.

Error

Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.

Name Typ Description
code

ErrorCode

Kód chyby nejvyšší úrovně
details

Error[]

Další podrobnosti podpory týkající se chyby nebo očekávaných zásad
innererror

InnerError

Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a cíl volitelných vlastností, vnitřní chybu (může být vnořená).
message

string

Chybová zpráva nejvyšší úrovně.
target

string

Zdroj chyby. Například v případě neplatného modelu by to bylo "model" nebo "id modelu".

ErrorCode

Kód chyby nejvyšší úrovně

Name Typ Description
BadArgument

string

BadRequest

string

Forbidden

string

InternalServerError

string

NotFound

string

ServiceUnavailable

string

TooManyRequests

string

Unauthorized

string

UnsupportedMediaType

string

ErrorResponse

Odpověď na chybu se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name Typ Description
error

Error

Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.

InnerError

Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a cíl volitelných vlastností, vnitřní chybu (může být vnořená).

Name Typ Description
code

string

Podrobný kód chyby, který vám pomůže s diagnostikou
innererror

InnerError

Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a cíl volitelných vlastností, vnitřní chybu (může být vnořená).
message

string

Podrobná chybová zpráva
target

string

Zdroj chyby. Například v případě neplatného modelu by to bylo "model" nebo "id modelu".

Model

Objekt modelu

Name Typ Description
consentId

string

ID prostředku
createdDateTime

string

Časové razítko, kdy byl objekt vytvořen. Časové razítko je kódováno jako formát data a času ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description

string

Popis modelu
engineVersion

string

Verze modulu. Aktualizace této verze může získat nejnovější opravu chyby výslovnosti.
id

string

ID prostředku
lastActionDateTime

string

Časové razítko, kdy byl zadán aktuální stav. Časové razítko je kódováno jako formát data a času ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale

string

Národní prostředí tohoto modelu. Kód národního prostředí se řídí BCP-47. Seznam národního prostředí pro převod textu na řeč najdete tady https://video2.skills-academy.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId

string

ID prostředku
properties

ModelProperties

Vlastnosti modelu
recipe

Recipe

Recept na vytváření modelů Různé recepty mají různé možnosti.
status

Status

Stav prostředku.
trainingSetId

string

ID prostředku
voiceName

string

Hlasové jméno

ModelFailureReason

Důvod selhání trénování modelu

Name Typ Description
InaccessibleCustomerStorage

string

Zákazník používá funkci Přineste si vlastní úložiště v účtu Speech. Úložiště ale teď není přístupné. Podívejte se prosím na dokument.
Internal

string

Chyba vlastní hlasové služby.
SpeakerVerificationFailed

string

Zvuk souhlasu a trénování nejsou od stejného mluvčího.
TerminateByUser

string

Zákazník zrušil trénování modelu.

ModelProperties

Vlastnosti modelu

Name Typ Description
failureReason

ModelFailureReason

Důvod selhání trénování modelu
presetStyles

string[]

Přednastavené styly tohoto modelu
styleTrainingSetIds

object

Přizpůsobené styly a přidružené trénovací sady
voiceStyles

string[]

Všechny styly podporované tímto modelem

PresetStyleItem

Přednastavené styly podporované v receptu Hlasový model může tyto styly podporovat bez jakékoli sady trénování stylu.

Name Typ Description
female

string[]

Přednastavené styly podporované u ženského hlasového modelu.
male

string[]

Přednastavené styly podporované u modelu mužského hlasu.

Recipe

Recept na vytváření modelů Různé recepty mají různé možnosti.

Name Typ Description
datasetLocales

string[]

Národní prostředí trénovací datové sady. Kód národního prostředí se řídí BCP-47. Seznam národního prostředí pro převod textu na řeč najdete tady https://video2.skills-academy.com/azure/ai-services/speech-service/language-support?tabs=tts.
description

string

Popis receptu
kind

string

Druh receptu
maxCustomStyleNum

integer

Maximální počet přizpůsobených stylů podporovaný v jednom hlasovém modelu.
minStyleUtteranceCount

integer

Minimální počet promluv potřebný k trénování každého přizpůsobeného stylu.
minUtteranceCount

integer

Minimální počet promluv potřebný k trénování hlasového modelu pomocí tohoto receptu
modelLocales

string[]

Národní prostředí, které hlasový model může pomocí tohoto receptu mluvit. Kód národního prostředí se řídí BCP-47. Seznam národního prostředí pro převod textu na řeč najdete tady https://video2.skills-academy.com/azure/ai-services/speech-service/language-support?tabs=tts.
presetStyles

<string,  PresetStyleItem>

Přednastavené styly podporované tímto receptem na národní prostředí. Tyto styly můžete získat bez jakékoli trénovací sady stylů.
version

string

Verze receptu

Status

Stav prostředku.

Name Typ Description
Disabled

string

Disabling

string

Failed

string

NotStarted

string

Running

string

Succeeded

string