Projects - Create

Service:

Cognitive Services - Custom Voice

API Version:

2023-12-01-preview

Vytvoří nový projekt.

PUT {endpoint}/customvoice/projects/{id}?api-version=2023-12-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. Regex pattern: ^[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	Sem zadejte svůj klíč prostředku služby Speech.

Text požadavku

Name	Vyžadováno	Typ	Description
kind	True	ProjectKind	Druh projektu
description		string	Popis projektu
displayName		string	Název projektu
id		string	ID prostředku

Odpovědi

Name	Typ	Description
201 Created	Project	Vytvořeno
Other Status Codes	ErrorResponse	Došlo k chybě.

Zabezpečení

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

Příklady

Create a project

Sample Request

HTTP

PUT {endpoint}/customvoice/projects/Jessica?api-version=2023-12-01-preview


{
  "description": "Project for Jessica Voice",
  "kind": "ProfessionalVoice"
}

Sample Response

Status code:

201

{
  "id": "Jessica",
  "description": "Project for Jessica Voice",
  "kind": "ProfessionalVoice",
  "createdDateTime": "2023-04-01T05:30:00.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 volitelný cíl vlastností, vnitřní chybu (může být vnořená).
Project	Objekt projektu. Souhlasy, trénovací sady, modely a koncové body jsou uspořádané v projektu.
ProjectKind	Druh projektu

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ší podpůrné podrobnosti 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 volitelný cíl vlastností, vnitřní chybu (může být vnořená).
message	string	Chybová zpráva nejvyšší úrovně
target	string	Zdroj chyby. V případě neplatného modelu by to bylo například "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 volitelný cíl 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 volitelný cíl vlastností, vnitřní chybu (může být vnořená).
message	string	Podrobná chybová zpráva
target	string	Zdroj chyby. V případě neplatného modelu by to bylo například "model" nebo "id modelu".

Project

Objekt projektu. Souhlasy, trénovací sady, modely a koncové body jsou uspořádané v projektu.

Name	Typ	Description
createdDateTime	string	Časové razítko, kdy byl objekt vytvořen. Časové razítko je kódované 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 projektu
displayName	string	Název projektu
id	string	ID prostředku
kind	ProjectKind	Druh projektu

ProjectKind

Druh projektu

Name	Typ	Description
PersonalVoice	string
ProfessionalVoice	string