Read In Stream - Read In Stream
このインターフェイスを使用して読み取り操作の結果を取得し、テキストの多いドキュメント用に最適化された最新の光学式文字認識 (OCR) アルゴリズムを使用します。 読み取りインターフェイスを使用する場合、応答には "Operation-Location" というフィールドが含まれます。 'Operation-Location' フィールドには、OCR 結果にアクセスするために 'GetReadResult' 操作に使用する必要がある URL が含まれています。
POST {Endpoint}/vision/v3.1/read/analyze
POST {Endpoint}/vision/v3.1/read/analyze?overload=stream&language={language}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
Endpoint
|
path | True |
string |
サポートされている Cognitive Services エンドポイント。 |
language
|
query |
ドキュメント内のテキストの BCP-47 言語コード。 現時点では、英語 ('en')、オランダ語 ('nl')、フランス語 ('fr')、ドイツ語 ('de')、イタリア語 ('it')、ポルトガル語 ('pt)、スペイン語 ('es') のみがサポートされています。 Read では自動言語識別と多言語ドキュメントがサポートされているため、ドキュメントをその特定の言語として強制的に処理する場合にのみ言語コードを提供します。 |
要求ヘッダー
Media Types: "application/octet-stream"
名前 | 必須 | 型 | 説明 |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
要求本文
Media Types: "application/octet-stream"
名前 | 型 | 説明 |
---|---|---|
Image |
object (file) |
イメージ ストリーム。 |
応答
名前 | 型 | 説明 |
---|---|---|
202 Accepted |
サービスは要求を受け入れ、後で処理を開始します。 ヘッダー Operation-Location: string |
|
Other Status Codes |
エラー応答。 |
セキュリティ
Ocp-Apim-Subscription-Key
型:
apiKey
/:
header
例
Successful Analyze request
要求のサンプル
POST {Endpoint}/vision/v3.1/read/analyze?overload=stream&language=en
"{binary}"
応答のサンプル
定義
名前 | 説明 |
---|---|
Computer |
API 要求エラーの詳細。 |
Computer |
エラー コード。 |
Ocr |
ドキュメント内のテキストの BCP-47 言語コード。 現時点では、英語 ('en')、オランダ語 ('nl')、フランス語 ('fr')、ドイツ語 ('de')、イタリア語 ('it')、ポルトガル語 ('pt)、スペイン語 ('es') のみがサポートされています。 Read では自動言語識別と多言語ドキュメントがサポートされているため、ドキュメントをその特定の言語として強制的に処理する場合にのみ言語コードを提供します。 |
ComputerVisionError
API 要求エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
code |
エラー コード。 |
|
message |
string |
サービスによって報告されたエラーを説明するメッセージ。 |
requestId |
string |
一意の要求識別子。 |
ComputerVisionErrorCodes
エラー コード。
値 | 説明 |
---|---|
BadArgument | |
CancelledRequest | |
DetectFaceError | |
FailedToProcess | |
InternalServerError | |
InvalidDetails | |
InvalidImageFormat | |
InvalidImageSize | |
InvalidImageUrl | |
InvalidModel | |
InvalidThumbnailSize | |
NotSupportedFeature | |
NotSupportedImage | |
NotSupportedLanguage | |
NotSupportedVisualFeature | |
StorageException | |
Timeout | |
Unspecified | |
UnsupportedMediaType |
OcrDetectionLanguage
ドキュメント内のテキストの BCP-47 言語コード。 現時点では、英語 ('en')、オランダ語 ('nl')、フランス語 ('fr')、ドイツ語 ('de')、イタリア語 ('it')、ポルトガル語 ('pt)、スペイン語 ('es') のみがサポートされています。 Read では自動言語識別と多言語ドキュメントがサポートされているため、ドキュメントをその特定の言語として強制的に処理する場合にのみ言語コードを提供します。
値 | 説明 |
---|---|
de | |
en | |
es | |
fr | |
it | |
nl | |
pt |