Document Models - Analyze Document From Stream

Servicio:

Azure AI Services

Versión de la API:

2024-11-30

Analiza el documento con el modelo de documento.

POST {endpoint}/documentintelligence/documentModels/{modelId}:analyze?api-version=2024-11-30

Con parámetros opcionales:

POST {endpoint}/documentintelligence/documentModels/{modelId}:analyze?api-version=2024-11-30&pages={pages}&locale={locale}&stringIndexType={stringIndexType}&features={features}&queryFields={queryFields}&outputContentFormat={outputContentFormat}&output={output}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string uri	Punto de conexión del servicio De inteligencia de documentos.
modelId	path	True	string	Nombre único del modelo de documento. Patrón de Regex: ^[a-zA-Z0-9][a-zA-Z0-9._~-]{1,63}$
api-version	query	True	string	Versión de la API que se va a usar para esta operación.
features	query		DocumentAnalysisFeature[]	Lista de características de análisis opcionales.
locale	query		string	Sugerencia de configuración regional para el reconocimiento de texto y el análisis de documentos. El valor solo puede contener el código de idioma (por ejemplo, "en", "fr") o la etiqueta de idioma BCP 47 (por ejemplo, "en-US").
output	query		AnalyzeOutputOption[]	Salidas adicionales que se van a generar durante el análisis.
outputContentFormat	query		DocumentContentFormat	Formato del contenido de nivel superior de análisis de resultados.
pages	query		string	Números de página basados en 1 que se van a analizar. Ex. "1-3,5,7-9" Patrón de Regex: ^(\d+(-\d+)?)(,\s*(\d+(-\d+)?))*$
queryFields	query		string[]	Lista de campos adicionales que se van a extraer. Ex. "NumberOfGuests,StoreNumber"
stringIndexType	query		StringIndexType	Método usado para calcular el desplazamiento y la longitud de la cadena.

Cuerpo de la solicitud

Media Types: "application/octet-stream", "application/pdf", "image/jpeg", "image/png", "image/tiff", "image/bmp", "image/heif", "text/html", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.openxmlformats-officedocument.presentationml.presentation"

Nombre	Tipo	Description
input	string	Contenido de entrada.

Respuestas

Nombre	Tipo	Description
202 Accepted		La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado. Encabezados Operation-Location: string Retry-After: integer
Other Status Codes	DocumentIntelligenceErrorResponse	Una respuesta de error inesperada.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

OAuth2Auth

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize
Dirección URL del token: https://login.microsoftonline.com/common/oauth2/token

Ámbitos

Nombre	Description
https://cognitiveservices.azure.com/.default

Ejemplos

Analyze Document from Url

Solicitud de ejemplo

HTTP

POST https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentModels/customModel:analyze?api-version=2024-11-30&pages=1-2,4&locale=en-US&stringIndexType=textElements

"{binaryFile}"

Respuesta de muestra

status code:

202

Operation-Location: https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentModels/customModel/analyzeResults/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2024-11-30

Definiciones

Nombre	Description
AnalyzeOutputOption	Salidas adicionales que se van a generar durante el análisis.
DocumentAnalysisFeature	Características de análisis de documentos que se van a habilitar.
DocumentContentFormat	Formato del contenido en el resultado analizado.
DocumentIntelligenceError	Objeto de error.
DocumentIntelligenceErrorResponse	Objeto de respuesta de error.
DocumentIntelligenceInnerError	Objeto que contiene información más específica sobre el error.
StringIndexType	Método usado para calcular el desplazamiento y la longitud de la cadena.

AnalyzeOutputOption

Salidas adicionales que se van a generar durante el análisis.

Nombre	Tipo	Description
figures	string	Genere imágenes recortadas de figuras detectadas.
pdf	string	Generar una salida PDF en la que se puede buscar.

DocumentAnalysisFeature

Características de análisis de documentos que se van a habilitar.

Nombre	Tipo	Description
barcodes	string	Habilite la detección de códigos de barras en el documento.
formulas	string	Habilite la detección de expresiones matemáticas en el documento.
keyValuePairs	string	Habilite la detección de pares de valores de clave general (campos de formulario) en el documento.
languages	string	Habilite la detección del idioma de contenido de texto.
ocrHighResolution	string	Realice OCR en una resolución más alta para controlar documentos con impresión fina.
queryFields	string	Habilite la extracción de campos adicionales a través del parámetro de consulta QueryFields.
styleFont	string	Habilite el reconocimiento de varios estilos de fuente.

DocumentContentFormat

Formato del contenido en el resultado analizado.

Nombre	Tipo	Description
markdown	string	Representación de Markdown del contenido del documento con encabezados de sección, tablas, etc.
text	string	Representación de texto sin formato del contenido del documento sin formato.

DocumentIntelligenceError

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	DocumentIntelligenceError[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	DocumentIntelligenceInnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

DocumentIntelligenceErrorResponse

Objeto de respuesta de error.

Nombre	Tipo	Description
error	DocumentIntelligenceError	Información de error.

DocumentIntelligenceInnerError

Objeto que contiene información más específica sobre el error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	DocumentIntelligenceInnerError	Error interno.
message	string	Representación legible del error.

StringIndexType

Método usado para calcular el desplazamiento y la longitud de la cadena.

Nombre	Tipo	Description
textElements	string	Carácter de visualización percibido por el usuario o clúster de grafos, tal como se define en Unicode 8.0.0.
unicodeCodePoint	string	Unidad de caracteres representada por un único punto de código unicode. Usado por Python 3.
utf16CodeUnit	string	Unidad de caracteres representada por una unidad de código Unicode de 16 bits. Se usa en JavaScript, Java y .NET.