Projects - Create

Servizio:: Azure AI Services

Versione API:: 2026-01-01

Crea un nuovo progetto.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	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.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
kind	True	ProjectKind	Project
description		string	Descrizione del Project
displayName		string minLength: 1	Nome Project
locale		string	Il locale di questo progetto. Il codice locale segue BCP-47. Puoi trovare qui la lista https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsdelle località di sintesi vocali.

Risposte

Nome	Tipo	Descrizione
201 Created	Project	La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

201 Created

Project

La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Create a project

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 201

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

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Project	Project oggetto. Consensu, set di addestramento, modelli e endpoint sono organizzati in un progetto.
ProjectKind	Project

Azure.Core.Foundations.Error

Oggetto

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Oggetto

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Oggetto

Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

Project

Oggetto

Project oggetto. Consensu, set di addestramento, modelli e endpoint sono organizzati in un progetto.

Nome	Tipo	Descrizione
createdDateTime	string (date-time)	Il timestamp in cui l'oggetto è stato creato. Il timestamp è codificato come data e ora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", vedi https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Descrizione del Project
displayName	string minLength: 1	Nome Project
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa
kind	ProjectKind	Project
locale	string	Il locale di questo progetto. Il codice locale segue BCP-47. Puoi trovare qui la lista https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsdelle località di sintesi vocali.

ProjectKind

Enumerazione

Project

Valore	Descrizione
ProfessionalVoice	ProfessionalVoice
PersonalVoice	PersonalVoice