Edit

Create a project for personal voice

Personal voice projects contain the user consent statement and the personal voice ID. You can create a personal voice project in the Microsoft Foundry portal or by using the custom voice REST API.

Create a project

To create a personal voice fine-tuning project in the Microsoft Foundry portal, follow these steps:

  1. Go to your Microsoft Foundry project in the Microsoft Foundry portal. If you need to create a project, see Create a Microsoft Foundry project.
  2. Select Fine-tuning from the left pane.
  3. Select the AI Service tab, and then select the Fine-tune button. The Fine-tune a model wizard opens.
  4. On the Basic details pane of the wizard:
    • Select Azure Speech - Text to Speech as the model to fine-tune.
    • Set Type to Personal voice.
    • Enter a Name and Description for the fine-tuning task.
    • Select the Language of the voice you want to create.
  5. Select Next.

The wizard continues to the Register voice talent step, where you add user consent.

Create a project

To create a personal voice project, use the Projects_Create operation of the custom voice API. Construct the request body according to the following instructions:

  • Set the required kind property to PersonalVoice. The kind can't be changed later.
  • Optionally, set the description property for the project description. The project description can be changed later.

Make an HTTP PUT request using the URI as shown in the following Projects_Create example.

  • Replace YourResourceKey with your Speech resource key.
  • Replace YourResourceName with your Speech resource name.
  • Replace ProjectId with a project ID of your choice. The case sensitive ID must be unique within your Speech resource. The ID will be used in the project's URI and can't be changed later.
curl -v -X PUT -H "Ocp-Apim-Subscription-Key: YourResourceKey" -H "Content-Type: application/json" -d '{
  "description": "Project description",
  "kind": "PersonalVoice"
} '  "https://YourResourceName.cognitiveservices.azure.com/customvoice/projects/ProjectId?api-version=2026-01-01"

You should receive a response body in the following format:

{
  "id": "ProjectId",
  "description": "Project description",
  "kind": "PersonalVoice",
  "createdDateTime": "2024-09-01T05:30:00.000Z"
}

You use the project id in subsequent API requests to add user consent and get a speaker profile ID.

Next steps