次の方法で共有

Personal Voices - Post

  • リファレンス
サービス:
Azure AI Services
API バージョン:
2024-02-01-preview

クライアント内のオーディオ ファイルを含む新しい個人用音声を作成します。

POST {endpoint}/customvoice/personalvoices/{id}?api-version=2024-02-01-preview

URI パラメーター

名前 / 必須 型 説明
projectId
 formData True

string

プロジェクト ID。

正規表現パターン: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
audioData
 formData

file

オーディオ ファイル。
description
 formData

string

このモデルの説明 (省略可能)。
displayName
 formData

string

このモデルの表示名。
properties
 formData

string

properties。
endpoint
 path True

string

サポートされている Cognitive Services エンドポイント (プロトコルとホスト名など)。 https://eastus.api.cognitive.microsoft.com
id
 path True

string

リソースの ID。

正規表現パターン: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version
 query True

string

この操作に使用する API バージョン。

要求ヘッダー

Media Types: "multipart/form-data"

名前 必須 型 説明
Ocp-Apim-Subscription-Key True

string

ここで Speech リソース キーを指定します。
Operation-Id

string

操作の状態モニターの ID。 Operation-Id ヘッダーが既存の操作と一致し、要求が前の要求と同じでない場合、400 Bad Request で失敗します。

正規表現パターン: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

応答

名前 型 説明
201 Created

PersonalVoice

作成済み

ヘッダー

  • Operation-Id: string
  • Operation-Location: string
Other Status Codes

ErrorResponse

エラーが発生しました。

ヘッダー

x-ms-error-code: string

セキュリティ

Ocp-Apim-Subscription-Key

ここで Speech リソース キーを指定します。

型: apiKey
/: header

例

Create a personal voice

要求のサンプル

POST {endpoint}/customvoice/personalvoices/Jessica-PersonalVoice?api-version=2024-02-01-preview

応答のサンプル

状態コード:
201 
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1321a2c0-9be4-471d-83bb-bc3be4f96a6f?api-version=2024-02-01-preview
Operation-Id: 1321a2c0-9be4-471d-83bb-bc3be4f96a6f
{
  "id": "Jessica-PersonalVoice",
  "speakerProfileId": "3059912f-a3dc-49e3-bdd0-02e449df1fe3",
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

定義

名前 説明
AzureBlobContentSource

Azure Blob Storage のコンテンツ。 次の例では、*.wavファイルhttps://contoso.blob.core.windows.net/voicecontainer/jessica/を表します
Error

最上位レベルのエラーは、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、エラー コード、メッセージ、詳細、ターゲット、およびよりわかりやすい詳細を含む内部エラーを含む最上位レベルのエラーが含まれます。
ErrorCode

最上位のエラー コード
ErrorResponse

エラー応答は、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。
InnerError

内部エラーは、 で使用できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須のプロパティ エラー コード、メッセージ、および省略可能なプロパティ ターゲット、内部エラー (これは入れ子にできます) が含まれます。
ModelFailureReason

モデル トレーニングの失敗の理由
PersonalVoice

個人用音声オブジェクト
PersonalVoiceProperties

個人用音声プロパティ
Status

リソースの状態。

AzureBlobContentSource

Azure Blob Storage のコンテンツ。 次の例では、*.wavファイルhttps://contoso.blob.core.windows.net/voicecontainer/jessica/を表します

名前 型 説明
containerUrl

string

SAS を使用した Azure Blob Storage コンテナーの URL。 読み取りと一覧表示の両方のアクセス許可が必要です。
extensions

string[]

ファイル名拡張子。
prefix

string

BLOB 名プレフィックス。

Error

最上位レベルのエラーは、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、エラー コード、メッセージ、詳細、ターゲット、およびよりわかりやすい詳細を含む内部エラーを含む最上位レベルのエラーが含まれます。

名前 型 説明
code

ErrorCode

最上位のエラー コード
details

Error[]

エラーや予想されるポリシーに関するその他のサポートの詳細。
innererror

InnerError

内部エラーは、 で使用できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須のプロパティ エラー コード、メッセージ、および省略可能なプロパティ ターゲット、内部エラー (これは入れ子にできます) が含まれます。
message

string

最上位レベルのエラー メッセージ。
target

string

エラーのソースです。 たとえば、無効なモデルの場合は、"model" または "model id" になります。

ErrorCode

最上位のエラー コード

名前 型 説明
BadArgument

string

BadRequest

string

Forbidden

string

InternalServerError

string

NotFound

string

ServiceUnavailable

string

TooManyRequests

string

Unauthorized

string

UnsupportedMediaType

string

ErrorResponse

エラー応答は、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。

名前 型 説明
error

Error

最上位レベルのエラーは、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、エラー コード、メッセージ、詳細、ターゲット、およびよりわかりやすい詳細を含む内部エラーを含む最上位レベルのエラーが含まれます。

InnerError

内部エラーは、 で使用できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須のプロパティ エラー コード、メッセージ、および省略可能なプロパティ ターゲット、内部エラー (これは入れ子にできます) が含まれます。

名前 型 説明
code

string

診断に役立つ詳細なエラー コード。
innererror

InnerError

内部エラーは、 で使用できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須のプロパティ エラー コード、メッセージ、および省略可能なプロパティ ターゲット、内部エラー (これは入れ子にできます) が含まれます。
message

string

詳細なエラー メッセージ。
target

string

エラーのソースです。 たとえば、無効なモデルの場合は、"model" または "model id" になります。

ModelFailureReason

モデル トレーニングの失敗の理由

名前 型 説明
InaccessibleCustomerStorage

string

顧客は、Speech アカウントで Bring Your Own Storage を使用します。 ただし、ストレージにはアクセスできません。 ドキュメントを確認してください。
Internal

string

カスタム音声サービス エラー。
SpeakerVerificationFailed

string

同意とトレーニング オーディオは、同じスピーカーからのものではありません。
TerminateByUser

string

顧客がモデル トレーニングを取り消しました。

PersonalVoice

個人用音声オブジェクト

名前 型 説明
audios

AzureBlobContentSource

Azure Blob Storage のコンテンツ。 次の例では、*.wavファイルhttps://contoso.blob.core.windows.net/voicecontainer/jessica/を表します
consentId

string

リソースの ID
createdDateTime

string

オブジェクトが作成されたときのタイムスタンプ。 タイムスタンプは、ISO 8601 の日付と時刻の形式 ("YYYY-MM-DDThh:mm:ssZ"、 を参照) https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representationsとしてエンコードされます。
description

string

個人の音声の説明
displayName

string

個人用音声の表示名
id

string

リソースの ID
lastActionDateTime

string

現在の状態が入力されたときのタイムスタンプ。 タイムスタンプは、ISO 8601 の日付と時刻の形式 ("YYYY-MM-DDThh:mm:ssZ"、 を参照) https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representationsとしてエンコードされます。
projectId

string

リソースの ID
properties

PersonalVoiceProperties

個人用音声プロパティ
speakerProfileId

string

個人の音声スピーカー プロファイル ID。このプロパティを SSML に入力します。
status

Status

リソースの状態。

PersonalVoiceProperties

個人用音声プロパティ

名前 型 説明
failureReason

ModelFailureReason

モデル トレーニングの失敗の理由

Status

リソースの状態。

名前 型 説明
Disabled

string

Disabling

string

Failed

string

NotStarted

string

Running

string

Succeeded

string