Process Image Pipeline Service.
POST {{baseUrl}}/session/services/processimagepipeline
The Process Image Pipeline Real-Time services executes a series of image services on a single image based on service properties. The order of services execution is as follows:: - Image Enhancement - Classify - Extract
Outputs of all executed services are combined and returned in the response.
Service Properties
Env - Metadata environment identifier. Value is one of
D
,T
orP
. Default value isP
.ImageProfile - If non empty, the incoming image is enhanced.
ReturnFileDataInline - Boolean. If true, then the resulting file is returned inline in the result item as a base64 encoded file. If false, then the resulting file is returned as a fileId and can be retrieved through the Files resource. Default value is true. Applicable only if image enhancement is done. File ID referncing the resulting file is returned as part of URI in
src
property of File object of Result Item.Classify - Boolean. Classify the image.
Extract - Boolean. Extract the image. If this is set then ClassifyAndExtract is performed on the image and “Classify” flag is ignored.
IncludeOcrData - Boolean. If true then the returned UIM data object will contain extracted characters information. Otherwise it won't.
Project - Optional string. The recognition project to use to classify the document. Valid values are
Default
for the Advanced Recognition andInformationExtraction
for the Information Extraction. If omitted,Default
is used.
Number of Request Items
This Real-Time Service supports one or more items.
Values Per Request Item
No values are necessary or used.
Files Per Request Item
There can only be one file in request item object. It can either be an embedded file or a reference to a file ID previously posted to the Files Resource.
Request Body
{"serviceProps"=>[{"name"=>"Env", "value"=>"D"}, {"name"=>"ImageProfile", "value"=>"DistractionRemoval"}, {"name"=>"Extract", "value"=>true}, {"name"=>"ReturnFileDataInline", "value"=>false}, {"name"=>"IncludeOcrData", "value"=>false}, {"name"=>"Project", "value"=>"InformationExtraction"}], "requestItems"=>[{"nodeId"=>1, "values"=>nil, "files"=>[{"name"=>"Wren", "value"=>"F_ac92828e036e402687e020dbb8f3f4c0TIF", "contentType"=>"image/tiff", "fileType"=>"tif"}]}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"returnStatus":{"status":200,"code":"OK0000","message":"","server":"WS-S406d66e561d54f99b74f71aeca31fc46IS"},"id":"Req34W_3","serviceName":"processimagepipeline","executionMilliSeconds":968,"licensePagesUsed":0,"licensePagesUsed2":0,"resultItems":[{"nodeId":1,"errorCode":"","errorMessage":"","values":[{"name":"BlackBarLeft","value":0},{"name":"BlackBarTop","value":0},{"name":"BlackBarRight","value":0},{"name":"BlackBarBottom","value":0},{"name":"TemplateId","value":"28"},{"name":"DocumentTypeName","value":"TestWren"},{"name":"DocBoundary","value":0},{"name":"ClassificationId","value":"d907a548196c4e35837dad51954cd3ed"},{"name":"UimData","value":{"docType":"TestWren","locale":"en-US","flaggedReason":null,"extractionId":"3aff08999e844ff6a31aff002b0fcb4a","packageName":"","nodeList":[{"name":"InvoiceNumber","isArray":false,"indexFieldType":"Number","labelText":"Invoice No.","isRequired":true,"controlType":"TextBox","data":[{"arrayIndex":0,"value":null,"fieldError":null,"mustConfirm":true,"choices":null,"locationRect":{"left":639,"top":144,"width":124,"height":30},"pageId":1,"confidence":100,"extractedCharacters":null}]}]}}],"files":[{"name":"Wren","value":"F_3dce19d31ad948c7a48e92cad7ee0090TIF","contentType":"image/tiff","src":"https://{host}/cp-rest/v2/session/files/F_3dce19d31ad948c7a48e92cad7ee0090TIF","fileType":"tif"}]}]}