# Alibaba Cloud OCR API

> Alibaba Cloud OCR API on Apizie: 76 endpoints (Supports accurate detection of multi-format layouts, complex document backgrounds, and varying lighting…, Supports structured recognition and output of fields including passenger name, ID card number, electronic…, Recognizes text in multiple image types through a unified OCR interface, including general text, personal ID…, Supports structured recognition and output of key fields, such as issue date, draft number, issuer…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-ocr-api`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/ocr-api
- Page: https://zieapi.vercel.app/api/cloud/aliyun-ocr-api
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-ocr-api/openapi.json

Alibaba Cloud OpenAPI for OCR (ocr-api, version 2021-07-07). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Supports accurate detection of multi-format layouts, complex document backgrounds, and varying lighting…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-advanced` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You cannot pass through both fields simultaneously or leave both empty. Image URL… |
| body | string | no | You must specify either this field or the URL field, but not both, and neither can be empty. Binary file of the image, with a maximum size… |
| OutputCharInfo | string | no | Specifies whether to output single-character recognition results. By default, this is not required. true: required; false: not required |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. By default, this feature is disabled. true: enables the feature; false: disables the… |
| OutputTable | string | no | Specifies whether to output table recognition results, including cell information. By default, this is not required. true: required;… |
| NeedSortPage | string | no | Specifies whether to output text blocks in sequential order. Default value: false. false: outputs text blocks from left to right and top… |
| OutputFigure | string | no | Specifies whether to enable pattern Detection. By default, this feature is disabled. true: enables the feature; false: disables the feature. |
| NoStamp | string | no | Specifies whether to enable stamp removal. By default, this feature is disabled. true: enables the feature; false: disables the feature. |
| Paragraph | string | no | Specifies whether paragraph segmentation is required. By default, this is not required. true: required; false: not required |
| Row | string | no | Specifies whether to return results line by line. By default, this feature is disabled. true: enables the feature; false: disables the… |

### Supports structured recognition and output of fields including passenger name, ID card number, electronic…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-air-itinerary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Either this field or the body field must be provided. You cannot pass both or leave both empty. The URL of the image (up to 2,048 bytes,… |
| body | string | no | Either this field or the URL field must be provided. You cannot pass both or leave both empty. The binary file of the image, up to 10 MB.… |

### Recognizes text in multiple image types through a unified OCR interface, including general text, personal ID…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-all-text` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Specify either this parameter or the body parameter. Do not specify both or leave both empty. The URL of the image. The URL can be up to… |
| body | string | no | Specify either this parameter or the URL parameter. Do not specify both or leave both empty. The binary binary file. The maximum file size… |
| Type | string | yes | The image type. This is a required parameter and only a single value can be specified. For supported image types, see Supplementary… |
| OutputFigure | string | no | Specifies whether to enable the figure detection feature. If enabled, the FigureInfo field is returned. For the metric description, see… |
| OutputQrcode | string | no | Specifies whether to enable the QR code detection feature. If enabled, the QrCodeInfo field is returned. For the metric description, see… |
| OutputBarCode | string | no | Specifies whether to enable the barcode detection feature. If enabled, the BarCodeInfo field is returned. For the metric description, see… |
| OutputStamp | string | no | Specifies whether to enable the seal detection feature. If enabled, the StampInfo field is returned. For the metric description, see the… |
| OutputCoordinate | string | no | The coordinate format to return (points or rectangle). points: four-point coordinates. rectangle: rotated rectangle. By default, you do… |
| OutputOricoord | string | no | Specifies whether to return the coordinates based on the original image. The system automatically processes images (such as auto-rotation… |
| OutputKVExcel | string | no | Specifies whether to convert the recognized structured information into an Excel file link. Default value: not required. true: Enable.… |
| PageNo | integer | no | When the image type is mixed invoice, VAT invoice, fixed-amount invoice, air itinerary, train ticket, VAT roll invoice, or general… |
| AdvancedConfig | string | no | When the image type is general text recognition (high-precision) (Type=Advanced), you can use this parameter to set optional features… |
| IdCardConfig | string | no | When the image type is ID card (Type=IdCard), you can use this field to configure optional features (JSON-encoded) |
| InternationalIdCardConfig | string | no | When the image type is international ID card (Type=InternationalIdCard), you can use this field to configure optional features… |
| InternationalBusinessLicenseConfig | string | no | When the image type is international business license (Type=InternationalBusinessLicense), you can use this field to configure optional… |
| MultiLanConfig | string | no | When the image type is general multi-language text (Type=MultiLang), you can use this field to configure optional features (JSON-encoded) |
| TableConfig | string | no | When the image type is table (Type=Table), you can use this field to configure optional features (JSON-encoded) |

### Supports structured recognition and output of key fields, such as issue date, draft number, issuer…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-bank-acceptance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide exactly one of them. Image URL (must not exceed 2048 bytes; base64… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide exactly one of them. Binary file of the image, up to 10 MB in size.… |

### It can quickly and accurately detect key information from a bank account opening permit, such as the account…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-bank-account-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one. Image URL (must not exceed 2048 bytes; base64 is… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one. Binary file of the image, up to 10 MB in size.… |

### It can accurately detect the bank card number and validity period on various types of bank cards. It…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-bank-card` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must specify one and only one, and neither can be empty. Image URL (must not… |
| body | string | no | This field and the URL field are mutually exclusive; you must specify one and only one, and neither can be empty. Binary file of the… |

### Quick and accurate character detection in images from online scenarios such as E-commerce product…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-basic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must specify one and only one of them. Image URL (must not exceed 2048 bytes;… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify one and only one of them. Binary file of the image, up to 10 MB in… |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. Default value: true. true: Enable rotation. false: Disable rotation. |

### It can accurately detect key information on birth certificates, such as date of birth, birth weight, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-birth-certification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one. Image URL (must not exceed 2048 bytes; base64 is… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one. Binary file of the image, up to 10 MB in size.… |

### Supports structured recognition and output of key fields such as title, invoice number, departure station,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-bus-ship-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (length must not exceed 2048 bytes; base64 is not supported) |
| body | string | no | Binary byte stream of the image, up to 10 MB |

### It can quickly and accurately detect key fields from enterprise business licenses, including the Unified…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-business-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one, and neither can be empty. Image URL (must not… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one, and neither can be empty. Binary file of the… |

### Supports structured recognition and output of key fields including invoice code, invoice number, invoice…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-car-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Either this field or the body field must be specified. You cannot specify both or leave both empty. The URL of the image (up to 2048… |
| body | string | no | Either this field or the URL field must be specified. You cannot specify both or leave both empty. The image binary file, up to 10 MB.… |

### Effectively detects vehicle license plate information. Support includes motor vehicle license plates,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-car-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you cannot pass through both or leave both empty. Image URL (must not exceed 2048… |
| body | string | no | This field and the URL field are mutually exclusive—you cannot pass through both or leave both empty. Binary file of the image, up to 10… |

### Supports detection of vehicle VIN codes.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-car-vin-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one and only one of them. Image URL (must not exceed 2048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one and only one of them. Binary file of the image, up to 10 MB in… |

### Supports structured content detection and recognition for passports of the People's Republic of China,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-chinese-passport` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (length must not exceed 2048 bytes; base64 is not supported) |
| body | string | no | Image binary byte stream, maximum size 10 MB |
| OutputFigure | string | no | Whether pattern detection is required; default is required |

### Supports structured recognition and output of key fields, such as invoice code, invoice number, seller name,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-common-printed-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (length must not exceed 2048 bytes; Base64 is not supported) |
| body | string | no | Image binary byte stream, maximum size 10 MB |

### Supports detection of key fields, including certificate name, enterprise name, unified social credit code,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-cosmetic-produce-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (length must not exceed 2048 bytes; Base64 is not supported) |
| body | string | no | Image binary byte stream, up to 10 MB |

### Supports structured output of six key fields—name, certificate number, sampling date, sampling time, testing…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-covid-test-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one. Image URL (must not exceed 2048 bytes in length;… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one. Binary file of the image, up to 10 MB in size.… |
| MultipleResult | string | no | Specifies whether to return multiple classification results when an image contains multiple subgraphs. By default, this is not required.… |

### It can quickly and accurately detect key fields on the ICP filing credential for Class II medical device…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-ctwo-medical-device-manage-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one and only one; they cannot both be passed through or both be… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one and only one; they cannot both be passed through or both be… |

### Structurally detects document information and provides layout information output from two perspectives:…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-document-structure` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | The URL of the image (must not exceed 2048 bytes and does not support Base64 encoding) |
| body | string | no | The binary file of the image, with a maximum size of 10 MB. You must specify either this parameter or Url. When invoking via HTTP, upload… |
| NeedRotate | string | no | Specifies whether to enable automatic rotation and return the rotation angle. By default, this feature is disabled. true: enable; false:… |
| OutputCharInfo | string | no | Specifies whether to output character-level recognition results. The default value is false. true: Enable this feature. false: Disable… |
| OutputTable | string | no | Specifies whether to output table recognition results, including cell information. The default value is false. true: Enable this feature.… |
| NeedSortPage | string | no | Specifies whether to output text blocks in a specific order. By default, ordering is disabled. true: enable ordering; false: disable… |
| Page | string | no | Specifies whether to enable paging. By default, this feature is disabled. true: enable; false: disable. This parameter does not take… |
| NoStamp | string | no | Specifies whether to remove seals. By default, this feature is disabled. true: enable; false: disable. |
| Paragraph | string | no | Specifies whether to enable paragraph segmentation. The default value is false. true: Enable this feature. false: Disable this feature.… |
| Row | string | no | Specifies whether to return results in row format. The default value is false. true: Enable this feature. false: Disable this feature.… |
| UseNewStyleOutput | string | no | Specifies whether to return results in the new output format. The default value is false |

### Supports structured extraction of fields such as name, license number, nationality, address, initial issue…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-driving-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one. Image URL (must not exceed 2048 bytes in length;… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one. Binary file of the image, up to 10 MB in size.… |

### Supports detection of printed mathematical formulas.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-edu-formula` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one of them, and cannot pass through both or leave both empty.… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one of them, and cannot pass through both or leave both empty.… |

### It can detect elementary school arithmetic problems and provide judgment results. It supports basic…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-edu-oral-calculation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one. Image URL (must not exceed 2048 bytes; base64 is… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one. Binary file of the image, up to 10 MB. When… |

### Supports structured electronic entry of supplementary exam papers across various subjects, automatically…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-edu-paper-cut` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one of them, but not both or neither. Image URL (must not exceed… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one of them, but not both or neither. Binary file of the image, up… |
| CutType | string | yes | Cropping type. question: question, answer: answer. |
| ImageType | string | yes | Image Type. scan: scanned graph, photo: photograph |
| Subject | string | no | Grade and subject. default: default, Math: Mathematics, PrimarySchool_Math: Elementary School Mathematics, JHighSchool_Math: Junior High… |
| OutputOricoord | string | no | Specifies whether to output the original image coordinate information (for example, if the image has been rotated or corrected). By… |

### Supports full-page OCR for K12 multi-subject scanning scenarios. The API supports OCR detection of printed…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-edu-paper-ocr` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must specify one and only one of them. Image URL (must not exceed 2048 bytes;… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify one and only one of them. Binary file of the image, up to 10 MB in… |
| ImageType | string | yes | Image type. scan: Scanned image; photo: Photograph |
| Subject | string | no | Grade and subject. default: Default, Math: Mathematics, PrimarySchool_Math: Elementary Mathematics, JHighSchool_Math: Junior High School… |
| OutputOricoord | string | no | Specifies whether to output the original image coordinate information (for example, if the image has been rotated or corrected). By… |

### Support structured detection of multi-subject teaching aid test papers, automatically splitting questions…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-edu-paper-structed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you cannot pass both or leave both empty. Image URL (must not exceed 2048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive—you cannot pass both or leave both empty. Binary file of the image, up to 10 MB in… |
| Subject | string | no | Grade and subject. default: Default, Math: Mathematics, PrimarySchool_Math: Elementary School Mathematics, JHighSchool_Math: Junior High… |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. By default, this feature is disabled. true: Enable; false: Disable. |
| OutputOricoord | string | no | Specifies whether to output original image coordinate information (for example, if the image has undergone rotation or correction). By… |

### It can effectively detect questions. By tagging elements within the questions, the detection performance is…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-edu-question-ocr` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | You must specify either this field or the BODY field, but not both, and neither can be empty. Image URL (must not exceed 2048 bytes in… |
| body | string | no | You must specify either this field or the URL field, but not both, and neither can be empty. Binary file of the image, up to 10 MB in… |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. By default, this feature is disabled. true: Enable automatic rotation. false: Disable… |

### Designed for efficiently detecting and recognizing printed English characters in fully English image-based…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-english` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must specify one and only one of them. Image URL (must not exceed 2 048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify one and only one of them. Binary file of the image, up to 10 MB in… |
| NeedRotate | string | no | Specifies whether automatic rotation is required. By default, it is not required. true: required; false: not required |
| OutputTable | string | no | Specifies whether to output the table recognition result, including cell information. By default, it is not required. true: required;… |

### Accurately detects key information from real estate certificates, including owner details, property address,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-estate-certification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the BODY field are mutually exclusive. You must specify one and only one; they cannot both be passed through or both be… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one and only one; they cannot both be passed through or both be… |

### Supports accurate detection of key fields in travel permits, such as name, date of birth, and certificate…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-exit-entry-permit-to-hk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (length must not exceed 2048 bytes; Base64 is not supported) |
| body | string | no | Image binary byte stream, up to 10 MB |
| OutputFigure | string | no | Output figure coordinate information for structured documents, such as profile picture on an ID card |

### Accurately detects key information from travel permits, including name, date of birth, certificate number,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-exit-entry-permit-to-mainland` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | You must specify either this field or the body field. You cannot pass through both fields simultaneously, nor can both be empty. Image URL… |
| body | string | no | You must specify either this field or the URL field. You cannot pass through both fields simultaneously, nor can both be empty. Binary… |
| OutputFigure | string | no | Specifies whether to enable pattern Detection. By default, this feature is disabled. true: Enable pattern Detection. false: Disable… |

### It can quickly and accurately detect key field information from a Food Operation License, including the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-food-manage-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one of them. Image URL (must not exceed 2048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one of them. Binary file of the image, up to 10 MB in… |

### It can quickly and accurately detect key field information contained in a food production license, such as…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-food-produce-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one and only one of them; they cannot both be passed through or… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one and only one of them; they cannot both be passed through or both… |

### Suitable for unstructured text recognition. Supports returning both the recognized text content and its…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-general` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must provide one and only one of them. Image URL (must not exceed 2048 bytes;… |
| body | string | no | This field and the URL field are mutually exclusive—you must provide one and only one of them. Binary file of the image, up to 10 MB in… |

### The general ticket extraction feature combines the capabilities of ReadLight OCR and the Qwen large language…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-general-structure` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you cannot pass both or leave both empty. Image URL (must not exceed 2048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive; you cannot pass both or leave both empty. Binary file of the image, up to 10 MB in… |
| Keys | string | no | An array of strings specifying all keys to be extracted. Default value is empty, which means the LLM automatically determines the keys to… |

### This API recognizes both Hong Kong Permanent Identity Cards and Hong Kong Identity Cards, detecting all card…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-hkidcard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Specify either this parameter or the body parameter. You cannot specify both or leave both empty. The image URL. The URL cannot exceed… |
| body | string | no | Specify either this parameter or the Url parameter. You cannot specify both or leave both empty. The binary file of the image. The maximum… |

### Supports handwriting recognition in complex scenarios, including Chinese handwriting, English handwriting,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-handwriting` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must specify one and only one. Image URL (up to 2048 bytes; base64 is not… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify one and only one. Binary file of the image, up to 10 MB. When… |
| OutputCharInfo | string | no | Specifies whether to output single-character recognition results. By default, this feature is disabled. true: Enable; false: Disable. |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. By default, this feature is disabled. true: Enable; false: Disable. |
| OutputTable | string | no | Specifies whether to output table recognition results, including cell information. By default, this feature is disabled. true: Enable;… |
| NeedSortPage | string | no | Specifies whether to output text blocks in order. The default value is false. false: Left to right, top to bottom; true: Top to bottom,… |
| Paragraph | string | no | Specifies whether the segment feature is required. By default, it is not required. true: required; false: not required. |

### Supports health codes from major provinces and cities across China, and outputs classification results for…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-health-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one of them, but not both or neither. Image URL (must not exceed… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one of them, but not both or neither. Binary file of the image, up… |

### Supports structured recognition and output of key fields such as room number, check-in date, departure date,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-hotel-consume` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes in length; base64 is not supported) |
| body | string | no | Binary byte stream of the image, up to 10 MB |

### It can structurally recognize the content of both the household registration page for permanent residents…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-household` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must provide one and only one of them. Image URL (must not exceed 2048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive—you must provide one and only one of them. Binary file of the image, up to 10 MB in… |
| IsResidentPage | string | no | Indicates whether the image is from the permanent resident page of a household register. Default value: No. true: required; false: not… |

### This API recognizes structured fields from both the front and back of a second-generation Chinese resident…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-idcard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Use either this parameter or the body parameter. You must specify one, but not both. The URL of the image. The URL must be less than 2,048… |
| body | string | no | Use either this parameter or the Url parameter. You must specify one, but not both. The binary data of the image. The size cannot exceed… |
| OutputFigure | string | no | Specifies whether to enable pattern detection. The default value is false. true: enables pattern detection. false: disables pattern… |
| OutputQualityInfo | string | no | Specifies whether to enable ID quality checks. The default value is false. Quality checks include detection for screen captures and… |
| Llm_rec | string | no | The Llm_rec |

### Supports business license types from Korea and India. Recognizes key fields such as certificate type,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-international-business-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | The URL of the image or PDF. The URL can be up to 2048 bytes in length. Base64 encoding is not supported |
| body | string | no | The binary byte stream of the image or PDF. Maximum size: 10 MB |
| Country | string | yes | The country name |

### It can perform structured recognition of foreign identity documents. Currently supported documents include…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-international-idcard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the BODY field are mutually exclusive—you must specify exactly one of them; they cannot both be passed through or both be… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify exactly one of them; they cannot both be passed through or both be… |
| Country | string | yes | Country name. Examples: India, Vietnam, Korea, Bangladesh |

### Supports structured recognition and output of key fields from VAT special invoices, VAT general invoices,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must specify one and only one. Image URL (must not exceed 2048 bytes in length… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify one and only one. Binary image file, up to 10 MB in size. When… |
| PageNo | integer | no | Specifies the page number of the PDF/OFD file to be recognized; for example, pageNo=6 recognizes the sixth page of the PDF/OFD file. If… |

### For scenarios involving fully Japanese-language image documents, this feature provides efficient Detection…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-janpanese` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must be no longer than 2048 bytes; Base64 encoding is not supported) |
| body | string | no | Binary image file, up to 10 MB in size. You must specify either this parameter or the URL parameter. To use HTTP invocation, place the… |
| OutputCharInfo | string | no | Specifies whether to output per-character recognition results |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. Rotation is automatically applied in structured detection, mixed-layout scenarios, and… |
| OutputTable | string | no | Specifies whether to output table recognition results, including cell information |

### Efficiently detects and recognizes Korean printed text in Korean image document scenarios, and supports…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-korean` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2 048 bytes; Base64 encoding is not supported) |
| body | string | no | Binary image file, up to 10 MB in size. Either this or the URL parameter must be provided. When using HTTP invocation, upload the binary… |
| OutputCharInfo | string | no | Specifies whether to output per-character recognition results |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. Rotation is automatically applied in structured detection, mixed-layout scenarios, and… |
| OutputTable | string | no | Specifies whether to output table recognition results, including cell information |

### Efficient detection and recognition of printed text in image documents for Latin-script scenarios,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-latin` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes in length; Base64 encoding is not supported) |
| body | string | no | Binary image file, up to 10 MB in size. Either this parameter or the URL parameter must be provided. When using HTTP, upload the binary… |
| OutputCharInfo | string | no | Specifies whether to output character-level recognition results |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. Rotation is automatically applied in structured detection, mixed-layout scenarios, and… |
| OutputTable | string | no | Specifies whether to output table recognition results, including cell information |

### Quickly and accurately detects key field information from a Medical Device Business License, including…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-medical-device-manage-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes; Base64 encoding is not supported) |
| body | string | no | Binary file of the image, up to 10 MB. Either this parameter or the URL parameter must be provided. When using HTTP, place the binary… |

### Quickly and accurately detects key field information contained in medical device manufacturing licenses,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-medical-device-produce-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes; Base64 encoding is not supported) |
| body | string | no | Binary file of the image, up to 10 MB. Either this parameter or URL must be provided. When using HTTP invocation, upload the binary file… |

### Supports structured recognition and output of key fields such as invoice code, total amount including tax,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-mixed-invoices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you cannot pass through both or leave both empty. Image URL (must not exceed 2048… |
| body | string | no | This field and the URL field are mutually exclusive—you cannot pass through both or leave both empty. Binary image file, up to 10 MB. When… |
| PageNo | integer | no | The page number of the PDF/OFD file to be recognized. If this field is empty or greater than the total number of pages in the PDF/OFD… |
| MergePdfPages | string | no | Specifies whether to merge the first few pages of a PDF and return the merged recognition result (supports up to the first 4 pages). For… |

### Supports automatic language categorization for major international language families and returns the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-multi-language` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you cannot pass through both or leave both empty. Image URL (must not exceed 2048… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify one and only one. Binary image file, up to 10 MB. When invoking via… |
| Languages | string | yes | List of supported languages. (JSON-encoded) |
| OutputCharInfo | string | no | Specifies whether to output character-level recognition results. By default, this feature is disabled. true: Enable; false: Disable. |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. By default, this feature is enabled. true: Enable; false: Disable. |
| OutputTable | string | no | Specifies whether to output the table detection result, including cell information. By default, this is not required. true: required;… |
| NeedSortPage | string | no | Specifies whether to output text blocks in order. The default value is false. false: Left to right, top to bottom; true: Top to bottom,… |

### Supports structured recognition and output of key fields such as invoice code, payer name, invoice number,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-non-tax-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one of them, and cannot pass through both or leave both empty.… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one of them, and cannot pass through both or leave both empty.… |

### Provides passport recognition services for major countries and regions worldwide, including the United…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-passport` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must specify one and only one. Image URL (must not exceed 2048 bytes; base64 is… |
| body | string | no | This field and the URL field are mutually exclusive; you must specify one and only one. Binary file of the image, up to 10 MB in size.… |

### Supports structured recognition and output of key fields such as recipient name, total amount, payment…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-payment-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one of them, but not both or neither. Image URL (must not exceed… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one of them, but not both or neither. Binary file of the image, up… |

### Supports structured recognition and output of key fields, such as order number, delivery information,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-purchase-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you must specify one and only one. Image URL (must not exceed 2048 bytes in length;… |
| body | string | no | This field and the URL field are mutually exclusive—you must specify one and only one. Binary file of the image, up to 10 MB in size. When… |
| OutputMultiOrders | string | no | Specifies whether to recognize multiple orders. By default, this feature is disabled. true: Enable; false: Disable. To use this parameter,… |

### Supports structured recognition and output of key fields such as invoice number, invoice code, and invoice…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-quota-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes; base64 is not supported) |
| body | string | no | Binary file of the image, up to 10 MB. Either this or the URL parameter must be provided. When using an HTTP request, place the binary… |

### Supports detection of all fields in ride-hailing trip receipts, including: service provider, applied on,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-ride-hailing-itinerary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (length must not exceed 2048 bytes; base64 is not supported) |
| body | string | no | Image binary byte stream, maximum size 10 MB |

### Supports structured recognition and output of key fields on roll invoices, including invoice code, invoice…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-roll-ticket` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes; base64 is not supported) |
| body | string | no | Binary file of the image, up to 10 MB. Either this or the URL parameter must be provided. When using HTTP invocation, upload the binary… |

### Provides efficient Detection and recognition of Russian printed text in Image document scenarios, with…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-russian` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2 048 bytes; Base64 encoding is not supported) |
| body | string | no | Binary image file, up to 10 MB in size. Either this or the URL parameter must be provided. When using HTTP invocation, place the binary… |
| OutputCharInfo | string | no | Indicates whether to output character-level recognition results |
| NeedRotate | string | no | Indicates whether to enable automatic rotation. Rotation is automatically applied in structured detection, mixed-layout scenarios, and… |
| OutputTable | string | no | Indicates whether to output table recognition results, including cell information |

### Supports structured recognition and output of key fields such as the invoice issuer name, invoice date,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-shopping-receipt` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes; Base64 is not supported) |
| body | string | no | Binary byte stream of the image, up to 10 MB |

### Supports recognition of all fields, including title, name, social security number, social security card…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-social-security-card` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (length must not exceed 2048 bytes; Base64 is not supported) |
| body | string | no | Image binary stream, maximum size 10 MB |

### Supports full-field detection, including title, name, Social Security number, Social Security card number,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-social-security-card-version-ii` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive—you cannot pass through both or leave both empty. Image URL (must not exceed 2048… |
| body | string | no | This field and the URL field are mutually exclusive—you cannot pass through both or leave both empty. Binary file of the image, up to 10… |

### Recognizes bordered tables, striped tables, and borderless tables
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-table-ocr` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Either this field or the body field must be specified. You cannot specify both or leave both empty. The URL of the image (maximum 2,048… |
| body | string | no | Either this field or the URL field must be specified. You cannot specify both or leave both empty. The binary binary file, maximum 10 MB.… |
| NeedRotate | string | no | Specifies whether automatic rotation is required. Default value: true. true: Required. false: Not required |
| LineLess | string | no | Specifies whether the table has no borders or has only horizontal lines without vertical lines. Default value: false (bordered). true:… |
| SkipDetection | string | no | Specifies whether to skip detection. Default value: false. true: Skip detection. false: Do not skip detection |
| IsHandWriting | string | no | Specifies whether the table is handwritten. Default value: false. true: The table is handwritten. false: The table is not handwritten.… |

### Supports structured recognition outputs of key fields, including tax authority, taxpayer identification…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-tax-clearance-certificate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must specify one and only one. Image URL (must not exceed 2048 bytes in length;… |
| body | string | no | This field and the URL field are mutually exclusive; you must specify one and only one. Binary file of the image, up to 10 MB in size.… |

### Supports structured recognition and output of key fields such as invoice code, invoice number, date, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-taxi-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must specify one and only one of them. Image URL (must not exceed 2048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive; you must specify one and only one of them. Binary file of the image, up to 10 MB in… |

### Efficient Detection and recognition of Thai printed text in Thai image document scenarios, with support for…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-thai` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2 048 bytes; Base64 encoding is not supported) |
| body | string | no | Binary image file, up to 10 MB in size. Use either this parameter or the URL parameter. When using HTTP, upload the binary image file in… |
| OutputCharInfo | string | no | Specifies whether to output character-level recognition results |
| NeedRotate | string | no | Specifies whether to enable automatic rotation. Rotation is automatically applied in structured detection, mixed-layout scenarios, and… |
| OutputTable | string | no | Specifies whether to output table recognition results, including cell information |

### Supports structured recognition and output of key fields such as invoice code, invoice number, amount, date,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-toll-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes; Base64 is not supported) |
| body | string | no | Image binary byte stream, up to 10 MB |

### Quickly and accurately detects key fields in a trademark registration certificate, such as the trademark…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-trade-mark-certification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | Image URL (must not exceed 2048 bytes; base64 is not supported) |
| body | string | no | Binary file of the image, up to 10 MB. Use either this parameter or the URL parameter. When using an HTTP request, upload the binary file… |

### Supports structured recognition and output of fields such as ticket number, departure station, arrival…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-train-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must specify one and only one, and neither can be empty or both passed through… |
| body | string | no | This field and the URL field are mutually exclusive; you must specify one and only one, and neither can be empty or both passed through… |

### Recognizes key fields from used car unified sales invoices, including invoice code, invoice number, invoice…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-used-car-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | The URL of the image. The URL is up to 2048 bytes in length. Base64 encoding is not supported |
| body | string | no | The binary byte stream of the image. Maximum size: 10 MB |

### Supports structured extraction of fields such as vehicle model, Vehicle Identification Number (VIN), chassis…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-vehicle-certification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one. Image URL (must not exceed 2048 bytes; base64 is… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one. Binary file of the image, up to 10 MB in size.… |

### Supports automatic localization and recognition of key fields on both the front and back pages of a vehicle…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-vehicle-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive; you must provide one and only one of them. Image URL (must not exceed 2048 bytes in… |
| body | string | no | This field and the URL field are mutually exclusive; you must provide one and only one of them. Binary file of the image, up to 10 MB in… |

### It can quickly and accurately detect key field information from a motor vehicle registration certificate,…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-vehicle-registration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one and only one of them; they cannot both be passed through or… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one and only one of them; they cannot both be passed through or both… |

### Supports detecting all key fields on the waybill.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-waybill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| Url | string | no | This field and the body field are mutually exclusive. You must specify one and only one of them; they cannot both be passed through or… |
| body | string | no | This field and the URL field are mutually exclusive. You must specify one and only one of them; they cannot both be passed through or both… |

### The business license verification service checks for consistency across three key elements: the Unified…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/verify-business-license` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| CreditCode | string | yes | The business registration number or Unified Social Credit Code |
| CompanyName | string | yes | The company name |
| LegalPerson | string | yes | The name of the company's legal representative |

### The VAT invoice verification API supports multiple invoice types, such as VAT special invoices, VAT ordinary…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/verify-vatinvoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |
| InvoiceCode | string | no | Invoice code. Leave blank for digital invoices (invoice type codes 31, 32, 51, 61, 83, or 84). See Invoice Type Code Reference for invoice… |
| InvoiceNo | string | yes | Invoice number |
| InvoiceDate | string | yes | Issue date in YYYYMMDD format |
| InvoiceSum | string | no | Invoice amount. Required for invoice type codes 01, 03, 15, 20, 31, 32, 51, 61, 85, 83, or 84. For codes 01, 03, 20, or 85, enter the… |
| VerifyCode | string | no | Verification code. Use the last six digits. Required for invoice type codes 04, 10, 11, 14, or 86. For code 86, use the last six digits of… |
| InvoiceKind | integer | no | Invoice type. Used to identify blockchain invoices. InvoiceKind=0 or blank means a non-blockchain invoice. InvoiceKind=1 means a… |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://ocr-api.cn-hangzhou.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-advanced" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud OCR API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-ocr-api/recognize-advanced with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud OCR API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud OCR itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud OCR API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-ocr-api.

### What is the status of the Alibaba Cloud OCR API?
Needs your own provider key (bring your own key)