Projects - Create

Service:

Azure AI Services

API-versie:

2026-01-01

Hiermee maakt u een nieuw project.

PUT {endpoint}/customvoice/projects/{id}?api-version=2026-01-01

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string (uri)	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: 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]$	De id van de resource.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
kind	True	ProjectKind	Project type
description		string	Project beschrijving
displayName		string minLength: 1	Project naam
locale		string	De landinstelling van dit project. De locatiecode volgt BCP-47. Je kunt hier de tekst-naar-spraak locatielijst https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsvinden.

Antwoorden

Name	Type	Description
201 Created	Project	De aanvraag is geslaagd en er is een nieuwe resource gemaakt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
https://cognitiveservices.azure.com/.default

Voorbeelden

Create a project

Voorbeeldaanvraag

HTTP

PUT {endpoint}/customvoice/projects/Jessica?api-version=2026-01-01

{
  "description": "Project for Jessica Voice",
  "kind": "ProfessionalVoice",
  "locale": "en-US"
}

Voorbeeldrespons

Statuscode:

201

{
  "description": "Project for Jessica Voice",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "id": "Jessica",
  "kind": "ProfessionalVoice",
  "locale": "en-US"
}

Definities

Name	Description
Azure.Core.Foundations.Error	Het foutobject.
Azure.Core.Foundations.ErrorResponse	Een antwoord met foutdetails.
Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie over de fout. Volgens Azure REST API-richtlijnen - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Project	Project object. Toestemmingen, trainingssets, modellen en eindpunten worden georganiseerd in een project.
ProjectKind	Project type

Azure.Core.Foundations.Error

Object

Het foutobject.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	Azure.Core.Foundations.Error[]	Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout.
innererror	Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie dan het huidige object over de fout.
message	string	Een leesbare weergave van de fout.
target	string	Het doel van de fout.

Azure.Core.Foundations.ErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	Azure.Core.Foundations.Error	Het foutobject.

Azure.Core.Foundations.InnerError

Object

Een object met meer specifieke informatie over de fout. Volgens Azure REST API-richtlijnen - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
innererror	Azure.Core.Foundations.InnerError	Interne fout.

Project

Object

Project object. Toestemmingen, trainingssets, modellen en eindpunten worden georganiseerd in een project.

Name	Type	Description
createdDateTime	string (date-time)	De tijdstempel waarop het object is gemaakt. De tijdstempel wordt gecodeerd als ISO 8601-datum- en tijdnotatie ('JJJJ-MM-DDThh:mm:ssZ', zie https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Project beschrijving
displayName	string minLength: 1	Project naam
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resource-id
kind	ProjectKind	Project type
locale	string	De landinstelling van dit project. De locatiecode volgt BCP-47. Je kunt hier de tekst-naar-spraak locatielijst https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsvinden.

ProjectKind

Opsomming

Project type

Waarde	Description
ProfessionalVoice	ProfessionalVoice
PersonalVoice	PersoonlijkStem