Transform Your Images into Text with Cognitive Actions

In today's digital world, the ability to convert images into editable text can significantly enhance productivity and streamline workflows. The "Image To Text" service offers powerful Cognitive Actions designed to extract textual information from images using advanced image processing techniques. This capability not only simplifies data entry tasks but also enables developers to integrate text extraction into a variety of applications, such as document management systems, accessibility tools, and content creation platforms.

Prerequisites

To get started with the "Image To Text" service, you'll need a Cognitive Actions API key and a basic understanding of making API calls.

Convert Image to Text

The primary action within the "Image To Text" service is the Convert Image to Text function. This action extracts text from an image, allowing developers to turn visual information into machine-readable text efficiently.

Purpose

The "Convert Image to Text" action addresses the challenge of digitizing printed or handwritten material. By providing an image URI, developers can obtain text predictions, enabling the automation of data entry and improving accessibility for visually impaired users.

Input Requirements

The input for this action requires an image in the form of a valid URI. The expected structure is as follows:

• Image: A string representing the URI of the input image to be processed. For example:

  {
    "image": "https://replicate.delivery/pbxt/KfRKQXB5OeI5SA4bnvr91JEJdwW8MfpOji3sXrXzBM6htQVa/image.jpg"
  }
  

Expected Output

Upon processing, the action returns a textual description of the image content. For instance, the output could be:

a photography of a busy city street with a trolley and cars

Use Cases for this Specific Action

• Document Digitization: Automate the extraction of text from scanned documents, making it easier to store and search digital copies.
• Content Creation: Streamline the process of generating content for blogs, articles, or social media by converting images of text into editable formats.
• Accessibility: Develop applications that assist visually impaired users by reading text from images aloud or converting it into braille.
• Data Entry Automation: Reduce manual data entry errors by extracting text from images of receipts, forms, or business cards.

import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "384d1383-d0db-494a-99fa-a6805ca15e4a" # Action ID for: Convert Image to Text

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "image": "https://replicate.delivery/pbxt/KfRKQXB5OeI5SA4bnvr91JEJdwW8MfpOji3sXrXzBM6htQVa/image.jpg"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

The "Image To Text" service offers a simple yet powerful way to convert images into text, unlocking numerous possibilities for developers looking to enhance their applications. By leveraging the "Convert Image to Text" action, you can automate data entry, improve accessibility, and streamline content creation processes. As a next step, consider integrating this functionality into your projects to see the benefits it can provide in real-world applications.