Projects - Create

Служба:: Azure AI Services

Версия API:: 2026-01-01

Создает проект.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например: 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]$	Идентификатор ресурса.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
kind	True	ProjectKind	Project type
description		string	Project description
displayName		string minLength: 1	Project name
locale		string	Локаль этого проекта. Код локации соответствует BCP-47. Вы можете найти список местоположения для превращения текста в речь здесь https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.

Ответы

Имя	Тип	Описание
201 Created	Project	Запрос успешно выполнен, и в результате был создан новый ресурс.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Имя

Тип

Описание

201 Created

Project

Запрос успешно выполнен, и в результате был создан новый ресурс.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Непредвиденное сообщение об ошибке.

Заголовки

x-ms-error-code: string

Безопасность

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://cognitiveservices.azure.com/.default

Примеры

Create a project

Образец запроса

HTTP

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

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

Пример ответа

Код состояния:: 201

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

Определения

Имя	Описание
Azure.Core.Foundations.Error	Объект ошибки.
Azure.Core.Foundations.ErrorResponse	Ответ, содержащий сведения об ошибке.
Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения об ошибке. Согласно Azure рекомендациям REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.
Project	Project object. Согласия, обучающие наборы, модели и конечные точки организованы в проекте.
ProjectKind	Project type

Azure.Core.Foundations.Error

Объект

Объект ошибки.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
details	Azure.Core.Foundations.Error[]	Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке.
innererror	Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения, чем текущий объект об ошибке.
message	string	Читаемое пользователем представление ошибки.
target	string	Целевой объект ошибки.

Azure.Core.Foundations.ErrorResponse

Объект

Ответ, содержащий сведения об ошибке.

Имя	Тип	Описание
error	Azure.Core.Foundations.Error	Объект ошибки.

Azure.Core.Foundations.InnerError

Объект

Объект, содержащий более конкретные сведения об ошибке. Согласно Azure рекомендациям REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
innererror	Azure.Core.Foundations.InnerError	Внутренняя ошибка.

Project

Объект

Project object. Согласия, обучающие наборы, модели и конечные точки организованы в проекте.

Имя	Тип	Описание
createdDateTime	string (date-time)	Временная метка, когда объект был создан. Метка времени кодируется в формате даты и времени ISO 8601 («YYYY-MM-DDThh:mm:ssZ», см. https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Project description
displayName	string minLength: 1	Project name
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Идентификатор ресурса
kind	ProjectKind	Project type
locale	string	Локаль этого проекта. Код локации соответствует BCP-47. Вы можете найти список местоположения для превращения текста в речь здесь https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.

ProjectKind

Перечисление

Project type

Значение	Описание
ProfessionalVoice	ProfessionalVoice
PersonalVoice	PersonalVoice