Transcriptions - Create

リファレンス

サービス:: Azure AI Services

API バージョン:: v3.2-preview.2

新しい文字起こしを作成します。

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名、例: https://westus.api.cognitive.microsoft.com)。

要求本文

名前	必須	型	説明
displayName	True	string minLength: 1	オブジェクトの表示名。
locale	True	string minLength: 1	格納されているデータのロケール。言語識別が使用されている場合、このロケールは、言語を検出できなかった音声を文字起こしするために使用されます。
contentContainerUrl		string (uri)	オーディオファイルを含む Azure BLOB コンテナーの URL。コンテナーの最大サイズは 5 GB で、BLOB の最大数は 1,0000 個です。 BLOB の最大サイズは 2.5 GB です。コンテナー SAS には、'r' (読み取り) アクセス許可と 'l' (リスト) アクセス許可が含まれている必要があります。このプロパティは応答では返されません。
contentUrls		string[] (uri)	文字起こしするオーディオファイルを取得するコンテンツ URL の一覧。最大 1,000 個の URL を使用できます。このプロパティは応答では返されません。
customProperties		object	このエンティティのカスタムプロパティ。許可されるキーの最大長は 64 文字、最大許容値の長さは 256 文字、許可されるエントリの数は 10 です。
dataset		EntityReference	EntityReference
description		string	オブジェクトの説明。
model		EntityReference	EntityReference
project		EntityReference	EntityReference
properties		TranscriptionProperties	TranscriptionProperties

応答

名前	型	説明
201 Created	Transcription	応答には、ペイロードとしてのエンティティとその場所に関する情報がヘッダーとして含まれます。ヘッダー Location: string
Other Status Codes	Error	エラーが発生しました。

名前

型

説明

201 Created

Transcription

応答には、ペイロードとしてのエンティティとその場所に関する情報がヘッダーとして含まれます。

ヘッダー

Location: string

Other Status Codes

Error

エラーが発生しました。

セキュリティ

Ocp-Apim-Subscription-Key

コグニティブサービスアカウントキーをここで指定します。

型: apiKey
/: header

Authorization

このリージョンの STS によって返される JWT からアクセストークンを指定します。 STS URL に次のクエリ文字列を追加して、トークンに管理スコープを追加してください: ?scope=speechservicesmanagement

型: apiKey
/: header

例

Create a transcription for URIs

Create a transcription from blob container

Create a transcription with basic two-speaker diarization

Create a transcription with language identification

Create a transcription with multispeaker diarization

Create a transcription for URIs

要求のサンプル

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation",
    "https://contoso.com/myotherstoragelocation"
  ],
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription using default model for en-US"
}

応答のサンプル

状態コード:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription from blob container

要求のサンプル

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentContainerUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/audiofiles/",
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription of storage container using default model for en-US"
}

応答のサンプル

状態コード:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with basic two-speaker diarization

要求のサンプル

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription using basic two-speaker diarization"
}

応答のサンプル

状態コード:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using basic two-speaker diarization",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with language identification

要求のサンプル

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "languageIdentification": {
      "mode": "Single",
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
        }
      }
    }
  },
  "locale": "fr-FR",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale."
}

応答のサンプル

状態コード:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S",
    "languageIdentification": {
      "mode": "Single",
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
        }
      }
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "fr-FR",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale.",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with multispeaker diarization

要求のサンプル

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "diarization": {
      "speakers": {
        "minCount": 3,
        "maxCount": 5
      }
    }
  },
  "locale": "en-US",
  "displayName": "Transcription using diarization for audio that is known to contain speech from 3-5 speakers"
}

応答のサンプル

状態コード:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S",
    "diarization": {
      "speakers": {
        "minCount": 3,
        "maxCount": 5
      }
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using diarization for audio that is known to contain speech from 3-5 speakers",
  "customProperties": {
    "key": "value"
  }
}

定義

名前	説明
DetailedErrorCode	DetailedErrorCode
DiarizationProperties	DiarizationProperties
DiarizationSpeakersProperties	DiarizationSpeakersProperties
EntityError	EntityError
EntityReference	EntityReference
Error	エラー
ErrorCode	エラーコード
InnerError	InnerError
LanguageIdentificationMode	LanguageIdentificationMode
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	ProfanityFilterMode
PunctuationMode	PunctuationMode
Status	ステータス
Transcription	テープ起こし
TranscriptionLinks	TranscriptionLinks
TranscriptionProperties	TranscriptionProperties

DetailedErrorCode

列挙

DetailedErrorCode

値	説明
DataImportFailed	データのインポートに失敗しました。
DeleteNotAllowed	削除は許可されていません。
DeployNotAllowed	デプロイは許可されていません。
DeployingFailedModel	失敗したモデルのデプロイ。
EmptyRequest	空の要求。
EndpointCannotBeDefault	エンドポイントを既定にすることはできません。
EndpointNotUpdatable	エンドポイントは更新できません。
EndpointWithoutLogging	ログ記録なしのエンドポイント。
ExceededNumberOfRecordingsUris	記録 URI の数を超えました。
FailedDataset	失敗したデータセット。
Forbidden	禁じられた。
InUseViolation	使用中の違反。
InaccessibleCustomerStorage	お客様のストレージにアクセスできません。
InvalidAdaptationMapping	適応マッピングが無効です。
InvalidBaseModel	ベースモデルが無効です。
InvalidCallbackUri	コールバック URI が無効です。
InvalidCollection	コレクションが無効です。
InvalidDataset	データセットが無効です。
InvalidDocument	ドキュメントが無効です。
InvalidDocumentBatch	ドキュメントバッチが無効です。
InvalidLocale	ロケールが無効です。
InvalidLogDate	ログの日付が無効です。
InvalidLogEndTime	ログの終了時刻が無効です。
InvalidLogId	無効なログ ID です。
InvalidLogStartTime	ログの開始時刻が無効です。
InvalidModel	モデルが無効です。
InvalidModelUri	モデル URI が無効です。
InvalidParameter	パラメーターが無効です。
InvalidParameterValue	パラメーター値が無効です。
InvalidPayload	ペイロードが無効です。
InvalidPermissions	アクセス許可が無効です。
InvalidPrerequisite	前提条件が無効です。
InvalidProductId	製品 ID が無効です。
InvalidProject	プロジェクトが無効です。
InvalidProjectKind	プロジェクトの種類が無効です。
InvalidRecordingsUri	無効な記録 URI。
InvalidRequestBodyFormat	要求本文の形式が無効です。
InvalidSasValidityDuration	SAS の有効期間が無効です。
InvalidSkipTokenForLogs	ログのスキップトークンが無効です。
InvalidSourceAzureResourceId	ソース Azure リソース ID が無効です。
InvalidSubscription	サブスクリプションが無効です。
InvalidTest	テストが無効です。
InvalidTimeToLive	有効期限が無効です。
InvalidTopForLogs	ログの top が無効です。
InvalidTranscription	文字起こしが無効です。
InvalidWebHookEventKind	Web フックイベントの種類が無効です。
MissingInputRecords	入力レコードがありません。
ModelCopyOperationExists	モデルのコピー操作が存在します。
ModelDeploymentNotCompleteState	モデルのデプロイが完了していない状態です。
ModelDeprecated	モデルは非推奨になりました。
ModelExists	モデルが存在します。
ModelMismatch	モデルの不一致。
ModelNotDeployable	モデルはデプロイできません。
ModelVersionIncorrect	モデルのバージョンが正しくありません。
NoUtf8WithBom	bom を含む utf8 はありません。
OnlyOneOfUrlsOrContainerOrDataset	URL またはコンテナーまたはデータセットのいずれか 1 つだけ。
ProjectGenderMismatch	プロジェクトの性別の不一致。
QuotaViolation	クォータ違反。
SingleDefaultEndpoint	単一の既定のエンドポイント。
SkuLimitsExist	SKU の制限が存在します。
SubscriptionNotFound	サブスクリプションが見つかりません。
UnexpectedError	予期しないエラー。
UnsupportedClassBasedAdaptation	サポートされていないクラスベースの適応。
UnsupportedDelta	サポートされていないデルタ。
UnsupportedDynamicConfiguration	サポートされていない動的構成。
UnsupportedFilter	サポートされていないフィルター。
UnsupportedLanguageCode	サポートされていない言語コード。
UnsupportedOrderBy	サポートされていない注文者。
UnsupportedPagination	サポートされていない改ページ位置。
UnsupportedTimeRange	サポートされていない時間範囲。

DiarizationProperties

Object

DiarizationProperties

名前	型	説明
speakers	DiarizationSpeakersProperties	DiarizationSpeakersProperties

DiarizationSpeakersProperties

Object

DiarizationSpeakersProperties

名前	型	説明
maxCount	integer (int32) minimum: 1	ダイアライゼーションのスピーカーの最大数。 36 未満で、minSpeakers プロパティ以上である必要があります。
minCount	integer (int32) minimum: 1	ダイアライゼーション用のスピーカーの最小数のヒント。 maxSpeakers プロパティ以下である必要があります。

EntityError

Object

EntityError

名前	型	説明
code	string	このエラーのコード。
message	string	このエラーのメッセージ。

EntityReference

Object

EntityReference

名前	型	説明
self	string (uri)	参照先エンティティの場所。

Error

Object

エラー

名前	型	説明
code	ErrorCode	エラーコード大まかなエラーコード。
details	Error[]	エラーや予想されるポリシーに関するその他のサポートの詳細。
innerError	InnerError	InnerError https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owで利用可能な Cognitive Services API ガイドラインに準拠した新しい内部エラー形式。これには、必須プロパティ ErrorCode、メッセージ、および省略可能なプロパティターゲット、details(キー値ペア)、内部エラー (入れ子にできます) が含まれます。
message	string	高レベルのエラーメッセージ。
target	string	エラーの原因。たとえば、無効なドキュメントの場合は "documents" または "document id" になります。

ErrorCode

列挙

エラーコード

値	説明
Conflict	競合エラーコードを表します。
Forbidden	禁止されているエラーコードを表します。
InternalCommunicationFailed	内部通信に失敗したエラーコードを表します。
InternalServerError	内部サーバーエラーコードを表します。
InvalidArgument	無効な引数のエラーコードを表します。
InvalidRequest	無効な要求エラーコードを表します。
NotAllowed	許可されていないエラーコードを表します。
NotFound	見つからないエラーコードを表します。
PipelineError	パイプラインエラーコードを表します。
ServiceUnavailable	サービスを使用できないエラーコードを表します。
TooManyRequests	要求の数が多すぎるエラーコードを表します。
Unauthorized	承認されていないエラーコードを表します。
UnprocessableEntity	処理不可能なエンティティエラーコードを表します。
UnsupportedMediaType	サポートされていないメディアの種類のエラーコードを表します。

InnerError

Object

InnerError

名前	型	説明
code	DetailedErrorCode	DetailedErrorCode 詳細なエラーコード列挙型。
details	object	エラーや予想されるポリシーに関するその他のサポートの詳細。
innerError	InnerError	InnerError https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owで利用可能な Cognitive Services API ガイドラインに準拠した新しい内部エラー形式。これには、必須プロパティ ErrorCode、メッセージ、および省略可能なプロパティターゲット、details(キー値ペア)、内部エラー (入れ子にできます) が含まれます。
message	string	高レベルのエラーメッセージ。
target	string	エラーの原因。たとえば、無効なドキュメントの場合は "documents" または "document id" になります。

LanguageIdentificationMode

列挙

LanguageIdentificationMode

値	説明
Continuous	継続的な言語識別 (既定)。
Single	単一言語の識別。

LanguageIdentificationProperties

Object

LanguageIdentificationProperties

名前	型	規定値	説明
candidateLocales	string[]		言語識別の候補ロケール (例: ["en-US", "de-DE", "es-ES"])。文字起こしのメインロケールを含め、少なくとも 2 個と最大 10 個の候補ロケールがサポートされています。
mode	LanguageIdentificationMode	Continuous	LanguageIdentificationMode 言語識別に使用されるモード。
speechModelMapping	<string, EntityReference>		ロケールと音声モデルエンティティの省略可能なマッピング。ロケールに対してモデルが指定されていない場合は、既定の基本モデルが使用されます。キーは候補ロケールに含まれるロケールである必要があり、値はそれぞれのロケールのモデルのエンティティです。

ProfanityFilterMode

列挙

ProfanityFilterMode

値	説明
Masked	最初の文字 (例: f*** を除く) で不適切な表現をマスクする
None	不適切な表現のフィルター処理を無効にします。
Removed	不適切な表現を削除します。
Tags	/Profanity><"不適切な表現" XML タグを追加する

PunctuationMode

列挙

PunctuationMode

値	説明
Automatic	自動句読点。
Dictated	ディクテーションされた句読点のみ、つまり明示的な句読点です。
DictatedAndAutomatic	ディクテーションされた句読点または自動句読点。
None	句読点なし。

Status

列挙

ステータス

値	説明
Failed	実行時間の長い操作が失敗しました。
NotStarted	実行時間の長い操作がまだ開始されていません。
Running	実行時間の長い操作は現在処理中です。
Succeeded	実行時間の長い操作が正常に完了しました。

Transcription

Object

テープ起こし

名前	型	説明
contentContainerUrl	string (uri)	オーディオファイルを含む Azure BLOB コンテナーの URL。コンテナーの最大サイズは 5 GB で、BLOB の最大数は 1,0000 個です。 BLOB の最大サイズは 2.5 GB です。コンテナー SAS には、'r' (読み取り) アクセス許可と 'l' (リスト) アクセス許可が含まれている必要があります。このプロパティは応答では返されません。
contentUrls	string[] (uri)	文字起こしするオーディオファイルを取得するコンテンツ URL の一覧。最大 1,000 個の URL を使用できます。このプロパティは応答では返されません。
createdDateTime	string (date-time)	オブジェクトが作成されたときのタイムスタンプ。タイムスタンプは ISO 8601 の日付と時刻の形式 ("YYYY-MM-DDThh:mm:ssZ"、 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations参照) としてエンコードされます。
customProperties	object	このエンティティのカスタムプロパティ。許可されるキーの最大長は 64 文字、最大許容値の長さは 256 文字、許可されるエントリの数は 10 です。
dataset	EntityReference	EntityReference
description	string	オブジェクトの説明。
displayName	string minLength: 1	オブジェクトの表示名。
lastActionDateTime	string (date-time)	現在の状態が入力されたときのタイムスタンプ。タイムスタンプは ISO 8601 の日付と時刻の形式 ("YYYY-MM-DDThh:mm:ssZ"、 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations参照) としてエンコードされます。
links	TranscriptionLinks	TranscriptionLinks
locale	string minLength: 1	格納されているデータのロケール。言語識別が使用されている場合、このロケールは、言語を検出できなかった音声を文字起こしするために使用されます。
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	TranscriptionProperties
self	string (uri)	このエンティティの場所。
status	Status	ステータス API の現在の状態について説明する

TranscriptionLinks

Object

TranscriptionLinks

名前	型	説明
files	string (uri)	このエンティティのすべてのファイルを取得する場所。詳細については、操作 "Transcriptions_ListFiles" を参照してください。

TranscriptionProperties

Object

TranscriptionProperties

名前	型	説明
channels	integer[] (int32)	要求されたチャネル番号のコレクション。既定のケースでは、チャネル 0 とチャネル 1 が考慮されます。
destinationContainerUrl	string (uri)	要求された宛先コンテナー。注釈変換先コンテナーを `timeToLive`と組み合わせて使用すると、文字起こしのメタデータは通常どおり削除されますが、このコンテナーに対する削除アクセス許可は必要ないため、文字起こしの結果を含む宛先コンテナーに格納されているデータは変更されません。自動クリーンアップをサポートするには、コンテナーで BLOB の有効期間を構成するか、BLOB をクリーンアップできる `destinationContainerUrl`の代わりに "Bring your own Storage (BYOS)" を使用します。
diarization	DiarizationProperties	DiarizationProperties
diarizationEnabled	boolean	ダイアライゼーション (話者識別) が要求されるかどうかを示す値。既定値は `false` です。このフィールドが true に設定され、改善されたダイアライゼーションシステムが `DiarizationProperties`を指定して構成されている場合、改善された diarization システムは、構成可能なスピーカーの範囲に対してダイアライゼーションを提供します。このフィールドが true に設定されていて、改善されたダイアライゼーションシステムが有効になっていない (`DiarizationProperties`を指定しない) 場合、基本のダイアライゼーションシステムは最大 2 つのスピーカーを区別します。基本ダイアライズには追加料金は適用されません。基本的な diarization システムは非推奨となり、次のメジャーバージョンの API で削除されます。この `diarizationEnabled` 設定も削除されます。
displayFormWordLevelTimestampsEnabled	boolean	表示フォームの単語レベルのタイムスタンプが要求されるかどうかを示す値。既定値は `false` です。
duration	string	文字起こしの期間。期間は ISO 8601 期間としてエンコードされます (「PnYnMnDTnHnMnS」を参照 https://en.wikipedia.org/wiki/ISO_8601#Durations)。
email	string	操作が完了した場合に電子メール通知を送信する電子メールアドレス。この値は、電子メールを正常に送信した後に削除されます。
error	EntityError	EntityError
languageIdentification	LanguageIdentificationProperties	LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode	ProfanityFilterMode 不適切な表現のフィルター処理のモード。
punctuationMode	PunctuationMode	PunctuationMode 句読点に使用されるモード。
timeToLive	string	文字起こしが完了した後にシステムに保持される期間。文字起こしが完了 (成功または失敗) した後の有効期間に達すると、自動的に削除されます。この値を設定しないか、0 に設定すると、自動削除が無効になります。サポートされている最も長い期間は 31 日です。期間は ISO 8601 期間としてエンコードされます (「PnYnMnDTnHnMnS」を参照 https://en.wikipedia.org/wiki/ISO_8601#Durations)。
wordLevelTimestampsEnabled	boolean	単語レベルのタイムスタンプが要求されるかどうかを示す値。既定値は `false` です。

次の方法で共有

Transcriptions - Create

URI パラメーター

要求本文

応答

セキュリティ

Ocp-Apim-Subscription-Key

Authorization

例

Create a transcription for URIs

要求のサンプル

応答のサンプル

Create a transcription from blob container

要求のサンプル

応答のサンプル

Create a transcription with basic two-speaker diarization

要求のサンプル

応答のサンプル

Create a transcription with language identification

要求のサンプル

応答のサンプル

Create a transcription with multispeaker diarization

要求のサンプル

応答のサンプル

定義

DetailedErrorCode

DiarizationProperties

DiarizationSpeakersProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

注釈

その他のリソース