StartTextDetection - Amazon Rekognition

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

StartTextDetection

保存されたビデオ内のテキストの非同期検出を開始します。

Amazon Rekognition Video は、Amazon S3 バケットに保存されたビデオ内のテキストを検出できます。を使用するVideoを使用して、動画のバケット名とファイル名を指定します。StartTextDetectionはジョブ識別子 (JobIdオペレーションの結果を取得するには、を使用します。テキスト検出が終了すると、Amazon Rekognition Video は完了ステータスを発行します。このサービスは、NotificationChannel

テキスト検出操作の結果を取得するには、まず Amazon SNS トピックに発行されるステータス値がSUCCEEDEDを呼び出します。もしそうならGetTextDetectionを呼び出し、ジョブ識別子 (JobId) を最初の呼び出しからStartTextDetection

リクエストの構文

{ "ClientRequestToken": "string", "Filters": { "RegionsOfInterest": [ { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number } } ], "WordFilter": { "MinBoundingBoxHeight": number, "MinBoundingBoxWidth": number, "MinConfidence": number } }, "JobTag": "string", "NotificationChannel": { "RoleArn": "string", "SNSTopicArn": "string" }, "Video": { "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } }

リクエストパラメータ

リクエストは以下のデータを JSON 形式で受け入れます。

ClientRequestToken

開始要求を識別するために使用される冪トークン。同じトークンをStartTextDetection要求では、同じJobId戻り値は。を使用するClientRequestTokenを使用して、同じジョブが偶発的に複数回開始されるのを防ぐことができます。

タイプ: 文字列

長さの制限: 最小長は 1 です。 最大長は 64 です。

パターン: ^[a-zA-Z0-9-_]+$

必須 いいえ

フィルター

テキストが応答に含めるために満たす必要のある条件を設定するためのオプションのパラメータ。

タイプ: StartTextDetectionFilters オブジェクト

必須 いいえ

JobTag

Amazon Simple Notification Service (SNS) トピックによって発行された完了ステータスで返される識別子。たとえば、を使用できます。JobTagを使用して、関連するジョブをグループ化し、完了通知でそれらを識別します。

タイプ: 文字列

長さの制限: 最小長は 1 です。 最大長は 256 です。

パターン: [a-zA-Z0-9_.\-:]+

必須 いいえ

通知チャネル

Amazon Rekognition がビデオ分析オペレーションの完了ステータスを発行する Amazon 簡易通知サービスのトピック。詳細については、「Amazon Rekognition Video 操作の呼び出し」を参照してください。Amazon SNS トピックには、AmazonRekognitionAmazonRekognitionServiceRole アクセス許可ポリシーを使用してトピックにアクセスしている場合。詳細については、「」を参照してください。複数の Amazon SNS トピックへのアクセスを許可する

タイプ: NotificationChannel オブジェクト

必須 いいえ

動画

Amazon S3 バケットに保存されたビデオファイル。Amazon Rekognition 動画開始操作StartLabelDetectionuseVideoをクリックして、分析するビデオを指定します。サポートされているファイル形式は、.mp4、.mov、および.avi です。

タイプ: Video オブジェクト

必須 はい

レスポンスの構文

{ "JobId": "string" }

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

JobId

テキスト検出ジョブ識別子。を使用するJobIdを呼び出して、後続の呼び出しでジョブを識別するGetTextDetection

タイプ: 文字列

長さの制限: 最小長は 1 です。 最大長は 64 です。

パターン: ^[a-zA-Z0-9-_]+$

Errors

AccessDeniedException

アクションを実行する権限がありません。

HTTP ステータスコード: 400

IdempotentParameterMismatchException

AClientRequestToken入力パラメータがオペレーションに再利用されましたが、他の入力パラメータの少なくとも 1 つが、オペレーションに対する前回の呼び出しとは異なります。

HTTP ステータスコード: 400

InternalServerError

Amazon Rekognition でサービスの問題が発生しました。もう一度やり直してください。

HTTP ステータスコード: 500

InvalidParameterException

入力パラメータが制約に違反しています。API オペレーションを再度呼び出す前にパラメータを検証します。

HTTP ステータスコード: 400

InvalidS3ObjectException

Amazon Rekognition は、リクエストで指定された S3 オブジェクトにアクセスできません。

HTTP ステータスコード: 400

LimitExceededException

Amazon Rekognition サービスの制限を超えました。たとえば、Amazon Rekognition Video ジョブを同時起動しすぎると、オペレーションの開始を呼び出し (StartLabelDetectionなど)は、LimitExceededExceptionの例外 (HTTP ステータスコード:400) を受け取ります。同時に実行されるジョブの数が Amazon Rekognition のサービスの制限を下回るまで、の例外 (HTTP ステータスコード:400) を受け取ります。

HTTP ステータスコード: 400

ProvisionedThroughputExceededException

お客様のスループット制限を超えたリクエストの数。この上限を引き上げる場合は、Amazon Rekognition itionまでお問い合わせください。

HTTP ステータスコード: 400

ThrottlingException

Amazon Rekognition は一時的にリクエストを処理できませんでした。もう一度やり直してください。

HTTP ステータスコード: 500

VideoTooLargeException

指定されたメディアのファイルサイズが大きすぎるか、時間が長すぎます。最大ファイルサイズは 10 GB の最大ファイルサイズは 10 GB です。最大期間は 6 時間です。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。