Read - Read

Service:

Azure AI Services

Version d'API:

3.1

Utilisez cette interface pour obtenir le résultat d’une opération de lecture, en utilisant les algorithmes de reconnaissance optique optique de caractères (OCR) de pointe optimisés pour les documents volumineux. Lorsque vous utilisez l’interface lecture, la réponse contient un champ appelé « Operation-Location ». Le champ « Operation-Location » contient l’URL que vous devez utiliser pour votre opération « GetReadResult » pour accéder aux résultats OCR.

POST {Endpoint}/vision/v3.1/read/analyze

Avec des paramètres facultatifs:

POST {Endpoint}/vision/v3.1/read/analyze?language={language}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string	Points de terminaison Cognitive Services pris en charge.
language	query		OcrDetectionLanguage	Code de langue BCP-47 du texte du document. Actuellement, seul l’anglais ('en'), le néerlandais ('nl'), le français ('fr'), l’allemand ('de'), l’italien ('it'), le portugais ('pt) et l’espagnol ('es') sont pris en charge. Lecture prend en charge l’identification automatique de la langue et les documents multi-langues. Fournissez donc uniquement un code de langue si vous souhaitez forcer le traitement du document comme langue spécifique.

En-tête de la demande

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string

Corps de la demande

Nom	Obligatoire	Type	Description
url	True	string	URL accessible publiquement d’une image.

Réponses

Nom	Type	Description
202 Accepted		Le service a accepté la demande et commencera à traiter ultérieurement. En-têtes Operation-Location: string
Other Status Codes	ComputerVisionError	Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Successful Analyze request

Exemple de requête

HTTP

POST {Endpoint}/vision/v3.1/read/analyze?language=en


{
  "url": "{url}"
}

Exemple de réponse

Code d’état:

202

Définitions

Nom	Description
ComputerVisionError	Détails sur l’erreur de demande d’API.
ComputerVisionErrorCodes	Code d’erreur.
ImageUrl
OcrDetectionLanguage	Code de langue BCP-47 du texte du document. Actuellement, seul l’anglais ('en'), le néerlandais ('nl'), le français ('fr'), l’allemand ('de'), l’italien ('it'), le portugais ('pt) et l’espagnol ('es') sont pris en charge. Lecture prend en charge l’identification automatique de la langue et les documents multi-langues. Fournissez donc uniquement un code de langue si vous souhaitez forcer le traitement du document comme langue spécifique.

ComputerVisionError

Object

Détails sur l’erreur de demande d’API.

Nom	Type	Description
code	ComputerVisionErrorCodes	Code d’erreur.
message	string	Message expliquant l’erreur signalée par le service.
requestId	string	Identificateur de demande unique.

ComputerVisionErrorCodes

Énumération

Code d’erreur.

Valeur	Description
BadArgument
CancelledRequest
DetectFaceError
FailedToProcess
InternalServerError
InvalidDetails
InvalidImageFormat
InvalidImageSize
InvalidImageUrl
InvalidModel
InvalidThumbnailSize
NotSupportedFeature
NotSupportedImage
NotSupportedLanguage
NotSupportedVisualFeature
StorageException
Timeout
Unspecified
UnsupportedMediaType

ImageUrl

Object

Nom	Type	Description
url	string	URL accessible publiquement d’une image.

OcrDetectionLanguage

Énumération

Code de langue BCP-47 du texte du document. Actuellement, seul l’anglais ('en'), le néerlandais ('nl'), le français ('fr'), l’allemand ('de'), l’italien ('it'), le portugais ('pt) et l’espagnol ('es') sont pris en charge. Lecture prend en charge l’identification automatique de la langue et les documents multi-langues. Fournissez donc uniquement un code de langue si vous souhaitez forcer le traitement du document comme langue spécifique.

Valeur	Description
de
en
es
fr
it
nl
pt