---
title: "OCR"
url: https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/ocr/
description: "Esta API te permite detectar caracteres textuales en imágenes y documentos y entregar el texto reconocido a través de Zia OCR."
last_updated: 2026-03-20T16:21:56Z
service: Zia Services
type: api
---

# Optical Character Recognition

[Zia Optical Character Recognition](https://docs.catalyst.zoho.com/es/zia-services/help/optical-character-recognition/introduction/) detecta electrónicamente caracteres textuales en imágenes o documentos digitales, y los convierte en texto codificado por máquina. Zia OCR puede reconocer texto en 10 idiomas principales.

> **Nota:** Catalyst no almacena ninguno de los archivos que subes en sus sistemas. Los archivos que subes se utilizan solo para procesamiento único. Tampoco se utilizan para propósitos de entrenamiento de modelos ML. Los componentes de Catalyst cumplen completamente con todas las leyes aplicables de protección de datos y privacidad.

# Ejecutar OCR

### Descripción

Esta API se usa para detectar caracteres textuales en imágenes y documentos, y entregar el texto reconocido como una respuesta JSON. La respuesta también contiene una puntuación de confianza, que define la precisión de la detección.

Debes especificar la ruta al archivo de imagen o documento en la solicitud de la API, como se muestra en la solicitud de ejemplo. Opcionalmente puedes especificar los idiomas presentes en el texto, para un procesamiento más rápido. OCR soporta 9 idiomas internacionales y 10 idiomas indios, que se mencionan en las tablas a continuación. El idioma se detecta automáticamente y el texto se procesa, si no se especifica.

### Detalles de la Solicitud

#### URL de Solicitud

`POST` {api-domain}/baas/v1/project/{project_id}/ml/ocr

- **api-domain** (URL): El dominio específico del DC para acceder a la API de Catalyst

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

#### Encabezados de Solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**content-type:** multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

**Encabezados Opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Alcance

ZohoCatalyst.mlkit.READ

#### Propiedades del JSON de Solicitud

- **image** (file, mandatory):  El archivo de entrada a procesar. Debes proporcionar la ruta en tu sistema local.

Formatos permitidos: *.webp, .jpeg, .png, .bmp, .tiff, .pdf* 

Límite de tamaño de archivo: 20 MB   

- **language** (string, optional):  El código de idioma del texto a identificar. Consulta las tablas a continuación para los códigos de idioma.  

#### Idiomas Internacionales Soportados por OCR

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Idioma</th>
			<th class="w50p">Códigos de Idioma</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Arabic</td>
			<td>`ara`</td>
		</tr>
		<tr>
			<td>Chinese</td>
			<td>`chi_sim`</td>
		</tr>
		<tr>
			<td>French</td>
			<td>`fra`</td>
		</tr>
		<tr>
			<td>Italian</td>
			<td>`ita`</td>
		</tr>
		<tr>
			<td>Japanese</td>
			<td>`jpn`</td>
		</tr>
		<tr>
			<td>Portuguese</td>
			<td>`por`</td>
		</tr>
		<tr>
			<td>Romanian</td>
			<td>`ron`</td>
		</tr>
		<tr>
			<td>Spanish</td>
			<td>`spa`</td>
		</tr>
	</tbody>
</table>

#### Idiomas Indios Soportados por OCR

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Idioma</th>
			<th class="w50p">Códigos de Idioma</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>English</td>
			<td>`eng`</td>
		</tr>
		<tr>
			<td>Hindi</td>
			<td>`hin`</td>
		</tr>
		<tr>
			<td>Bengali</td>
			<td>`ben`</td>
		</tr>
		<tr>
			<td>Marathi</td>
			<td>`mar`</td>
		</tr>
		<tr>
			<td>Telugu</td>
			<td>`tel`</td>
		</tr>
		<tr>
			<td>Tamil</td>
			<td>`tam`</td>
		</tr>
		<tr>
			<td>Gujarati</td>
			<td>`guj`</td>
		</tr>
		<tr>
			<td>Urdu</td>
			<td>`urd`</td>
		</tr>
		<tr>
			<td>Kannada</td>
			<td>`kan`</td>
		</tr>
		<tr>
			<td>Malayalam</td>
			<td>`mal`</td>
		</tr>
		<tr>
			<td>Sanskrit</td>
			<td>`san`</td>
		</tr>
	</tbody>
</table>

### Detalles de la Respuesta

La respuesta devuelve los `data` del procesamiento OCR, que incluyen el texto reconocido de la entrada en la clave `text` y la puntuación de confianza del reconocimiento en la clave `confidence`.

**Sample Request**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/ocr 
  -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
  -H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW" \
  -F "image=/Desktop/HelplineCard.webp"  \
  -F "language=eng,spa"

```

**Sample Response**

```json

	{
	"status":"success",
	"data": {
		"confidence":79.71514892578125,
		"text":"Whenever you\nneed to talk,\nwe're open\n\n[—] text eseses\n[J] KidsHelpPhone.ca\n\n(@, call 1—800—663—6868 Kids Help Phone ©"
	}	
	}
```

### SDK Documentation

[Add New User- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/zia-services/ocr)</br></br>
[Add New User- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/zia-services/ocr)</br></br>
[Add New User- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/zia-services/ocr)</br></br>