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



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

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

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

HTTPメソッドとパス

POST v1/skills/{skillId}/asrAnnotationSets
フィールド 説明 必須
skillId 文字列 URIパスに含むスキルIDです。

リクエスト

リクエストヘッダー

 Content-Type: application/json
 Accept: application/json

リクエスト本文

{
    "name": string
}
アトリビュート 説明 必須
name 文字列 アノテーションセットの名前(最大170文字)。

応答

HTTPステータス

HTTP 200 OK

応答ヘッダー

Content-Type: application/json
Location: v1/skills/{skillId}/asrAnnotationSets/{annotationSetId}
アトリビュート 説明 必須
skillId 文字列 LocationヘッダーのURIに含まれるスキルIDです。
annotationSetId 文字列 LocationヘッダーのURIに含まれるアノテーションセットIDです。

応答本文

{
   "id": string
}
アトリビュート 説明 必須
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" }] }