Streamline Document Processing with jichengdu/got-ocr-2 Cognitive Actions

23 Apr 2025
Streamline Document Processing with jichengdu/got-ocr-2 Cognitive Actions

In the world of document processing, Optical Character Recognition (OCR) plays a pivotal role in converting images of text into machine-readable formats. The jichengdu/got-ocr-2 API offers an advanced solution through its comprehensive set of Cognitive Actions, enabling developers to integrate powerful OCR capabilities into their applications. With enhanced speed, quality, and accuracy, these pre-built actions can drastically improve the efficiency of document management systems, data extraction processes, and more.

Prerequisites

Before diving into the integration of Cognitive Actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Familiarity with JSON format, as the input and output for these actions will be in JSON structure.
  • Basic knowledge of making HTTP requests, preferably using Python or similar programming languages.

Authentication typically involves passing your API key in the request headers, allowing you to securely access the available actions.

Cognitive Actions Overview

Conduct Unified OCR

Description:
Leverage a Unified End-to-end Model to perform OCR on images with enhanced speed, quality, and accuracy. The model supports formatting and HTML rendering options.

Category: document-ocr

Input

The input schema for this action requires the following:

  • imageFile (string, required): The URI of the input image file. This must be a valid URL.
  • format (boolean, optional): Indicates whether formatting and HTML rendering are enabled. The default value is false.

Example Input:

{
  "format": true,
  "imageFile": "https://replicate.delivery/pbxt/MhIqqSN3LCwdMskpa2GJFGmhPa00ZIQuUvXfxmu2WExPwA4x/1218867844_page_122_table_001.png"
}

Output

The output typically includes:

  • file (string): A URL linking to the rendered HTML output of the OCR process.
  • text (string): The extracted text formatted in LaTeX or similar, reflecting the content of the image.

Example Output:

{
  "file": "https://assets.cognitiveactions.com/invocations/f5815d8c-b436-4959-9f8d-d7999b92f40d/55448cc3-8c3e-44aa-b08b-1009cfab798b.html",
  "text": "\\begin{tabular}{|l|r|r|r|r|r|}\n\\hline \\multicolumn{1}{|c|}{ 项目 } & \\(\\mathbf{2 0 2 3}\\) 年 \\(\\mathbf{9}\\) 月末 & ... \\\\\n\\hline\n\\end{tabular}"
}

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the Conduct Unified OCR action using a hypothetical Cognitive Actions execution endpoint:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"  # Hypothetical endpoint

action_id = "3cb72a9d-f786-451b-b86f-06fd11bf563a"  # Action ID for Conduct Unified OCR

# Construct the input payload based on the action's requirements
payload = {
    "format": true,
    "imageFile": "https://replicate.delivery/pbxt/MhIqqSN3LCwdMskpa2GJFGmhPa00ZIQuUvXfxmu2WExPwA4x/1218867844_page_122_table_001.png"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable is structured according to the input schema, and the action ID is specified to target the Conduct Unified OCR action. The endpoint URL and request structure are illustrative and should be adapted to your specific implementation.

Conclusion

The jichengdu/got-ocr-2 Cognitive Actions provide developers with a powerful tool for enhancing document processing through effective OCR capabilities. By leveraging the Conduct Unified OCR action, you can streamline the extraction of text from images, enabling a wide range of applications from data analysis to content digitization. As you integrate these actions, consider exploring additional use cases, such as automating document workflows or improving data entry processes, to fully harness the power of OCR technology.

← Back to All Articles