自動音声認識（ASR）アノテーションセットの作成API

このAPIは、ASR評価用の空のアノテーションセットを作成します。アノテーションセットの作成後に音声ファイルのアノテーションを追加するには、アノテーションセットのアノテーション更新APIを呼び出します。

ASR評価のAPI実行手順の詳細については、APIフローを参照してください。

HTTPメソッドとパス

フィールド	型	説明	必須
skillId	文字列	URIパスに含むスキルIDです。	◯

リクエスト

リクエストヘッダー

リクエスト本文

アトリビュート	型	説明	必須
name	文字列	アノテーションセットの名前（最大170文字）。	◯

応答

HTTPステータス

応答ヘッダー

アトリビュート	型	説明	必須
skillId	文字列	LocationヘッダーのURIに含まれるスキルIDです。	◯
annotationSetId	文字列	LocationヘッダーのURIに含まれるアノテーションセットIDです。	◯

応答本文

アトリビュート	型	説明	必須
id	文字列	新規作成されたアノテーションセットのID。'amzn1.ask.asr-annotation-set.{UUID}'の形式です。例：amzn1.ask.asr-annotation-set.524575b7-d845-4b61-a472-ce6e1fe4210a	◯

エラー応答

このセクションでは、リクエスト固有のエラーについて説明します。すべてのASR APIに適用されるエラーのリファレンスについては、自動音声認識（ASR）APIエラーリファレンスを参照してください。

HTTPステータスコード	エラーコード	シナリオ
400 Bad Request	MISSING_REQUIRED_PROPERTY	リクエスト本文に必須フィールドがありません。
	CONTENT_PARSE_FAILURE	リクエスト本文の形式が正しくありません。
	INVALID_STRING_LENGTH	nameフィールドの長さが許容範囲外です。
	INVALID_REQUEST_PARAMETER	nameフィールドに無効な文字が含まれています。
404 Not Found	RESOURCE_NOT_FOUND	指定されたスキルが存在しません。
500 Internal Server Error	INTERNAL_SERVER_ERROR	内部サーバエラーのため、リクエストが失敗しました。

例

サンプルリクエスト	応答の例
POST /v1/skills/1234/asrAnnotationSets HTTP/1.1 Content-Type: application/json Accept: application/json { "name": "my annotation set name" }	HTTP 200 OK Content-Type: application/json Location: /v1/skills/1234/asrAnnotationSets/amzn1.ask-asr-evaluation.asid.524575b7-d845-4b61-a472-ce6e1fe4210a { "id": "amzn1.ask.asr-evaluation.524575b7-d845-4b61-a472-ce6e1fe4210a" }
POST /v1/skills/1234/asrAnnotationSets HTTP/1.1 Content-Type: application/json Accept: application/json { "name": "" }	HTTP 400 Bad Request Content-Type: application/json { "message": "Payload validations failed", "violations": [{ "message": "The \"name\" property at property path \"$.name\" is outside the allowed range.Actual length: 0, Minimum length: 1", "code": "INVALID_STRING_LENGTH" }] }
POST /v1/skills/1234/asrAnnotationSets HTTP/1.1 Content-Type: application/json Accept: application/json {}	HTTP 400 Bad Request Content-Type: application/json { "message": "Payload validations failed", "violations": [{ "message": "Object at property path \"$\" has missing required property \"name\"" "code": "MISSING_REQUIRED_PROPERTY" }] }