Projects - Create
Vytvoří nový projekt.
PUT {endpoint}/customvoice/projects/{id}?api-version=2026-01-01
Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://eastus.api.cognitive.microsoft.com). |
|
id
|
path | True |
string minLength: 3maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$ |
ID prostředku. |
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
| Name | Vyžadováno | Typ | Description |
|---|---|---|---|
| kind | True |
Project Kind |
|
| description |
string |
Popis Project |
|
| displayName |
string minLength: 1 |
Název Project |
|
| locale |
string |
Nastavení oblasti tohoto projektu. Kód místa odpovídá BCP-47. Seznam míst převodu textu na řeč najdete zde https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts. |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 201 Created |
Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek. |
|
| Other Status Codes |
Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string |
Zabezpečení
Ocp-Apim-Subscription-Key
Typ:
apiKey
V:
header
OAuth2Auth
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Name | Description |
|---|---|
| https://cognitiveservices.azure.com/.default |
Příklady
Create a project
Ukázkový požadavek
PUT {endpoint}/customvoice/projects/Jessica?api-version=2026-01-01
{
"description": "Project for Jessica Voice",
"kind": "ProfessionalVoice",
"locale": "en-US"
}
Ukázková odpověď
{
"description": "Project for Jessica Voice",
"createdDateTime": "2023-04-01T05:30:00.000Z",
"id": "Jessica",
"kind": "ProfessionalVoice",
"locale": "en-US"
}
Definice
| Name | Description |
|---|---|
|
Azure. |
Objekt chyby. |
|
Azure. |
Odpověď obsahující podrobnosti o chybě. |
|
Azure. |
Objekt obsahující konkrétnější informace o chybě. Podle Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors. |
| Project |
Project objekt. Souhlasy, tréninkové sady, modely a koncové body jsou organizovány v projektu. |
|
Project |
Project Kind |
Azure.Core.Foundations.Error
Objekt chyby.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Jedna ze serverově definovaných kódů chyb. |
| details |
Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě. |
|
| innererror |
Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě. |
|
| message |
string |
Čitelné znázornění chyby člověkem. |
| target |
string |
Cíl chyby. |
Azure.Core.Foundations.ErrorResponse
Odpověď obsahující podrobnosti o chybě.
| Name | Typ | Description |
|---|---|---|
| error |
Objekt chyby. |
Azure.Core.Foundations.InnerError
Objekt obsahující konkrétnější informace o chybě. Podle Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Jedna ze serverově definovaných kódů chyb. |
| innererror |
Vnitřní chyba. |
Project
Project objekt. Souhlasy, tréninkové sady, modely a koncové body jsou organizovány v projektu.
| Name | Typ | Description |
|---|---|---|
| createdDateTime |
string (date-time) |
Časové razítko při vytvoření objektu. Časové razítko je kódované jako formát data a času ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
| description |
string |
Popis Project |
| displayName |
string minLength: 1 |
Název Project |
| id |
string minLength: 3maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$ |
ID prostředku |
| kind |
Project Kind |
|
| locale |
string |
Nastavení oblasti tohoto projektu. Kód místa odpovídá BCP-47. Seznam míst převodu textu na řeč najdete zde https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts. |
ProjectKind
Project Kind
| Hodnota | Description |
|---|---|
| ProfessionalVoice |
ProfessionalVoice |
| PersonalVoice |
PersonalVoice |