Transform Your Images with the tjrndll/woodprints Cognitive Actions

24 Apr 2025
Transform Your Images with the tjrndll/woodprints Cognitive Actions

In the world of digital art and design, the ability to generate unique and visually appealing images can significantly enhance user experience and engagement. The tjrndll/woodprints Cognitive Actions provide a powerful API for developers to create images that mimic classic woodblock prints, utilizing customizable features for refinement and prompt strength. This article will guide you through the capabilities of the Generate Woodblock Style Image action, helping you integrate this functionality into your applications seamlessly.

Prerequisites

Before you can start using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform, which you will use to authenticate your requests.
  • Basic knowledge of making HTTP requests and handling JSON data in your preferred programming language.

Authentication generally involves passing your API key in the headers of your requests, ensuring secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Woodblock Style Image

The Generate Woodblock Style Image action allows you to create images that imitate the aesthetic of traditional woodblock prints using the style of TOK. This action offers various customizable options to refine the output according to your requirements.

Input

The input for this action adheres to the following schema:

  • prompt (string, required): A descriptive text prompt that guides the image generation. E.g., "an portrait of an astronaut in the style of TOK"
  • width (integer, optional): Specifies the width of the output image in pixels. Defaults to 1024.
  • height (integer, optional): Specifies the height of the output image in pixels. Defaults to 1024.
  • scheduler (string, optional): The algorithm used to schedule the denoising process. Defaults to "K_EULER".
  • outputCount (integer, optional): The number of images to generate, between 1 and 4. Defaults to 1.
  • guidanceScale (number, optional): The strength of the classifier-free guidance, ranging from 1 to 50. Defaults to 7.5.
  • applyWatermark (boolean, optional): Whether to apply a watermark to the generated image. Defaults to true.
  • negativePrompt (string, optional): Describes undesirable traits in the generated image.
  • promptStrength (number, optional): The strength of the prompt during img2img or inpainting, ranging from 0 to 1. Defaults to 0.8.
  • refinementType (string, optional): Specifies the type of refinement to use, with a default of "no_refiner".

Example Input:

{
  "width": 1024,
  "height": 1024,
  "prompt": "an portrait of an astronaut in the style of TOK",
  "scheduler": "K_EULER",
  "outputCount": 1,
  "guidanceScale": 7.5,
  "applyWatermark": true,
  "negativePrompt": "",
  "promptStrength": 0.8,
  "refinementType": "no_refiner"
}

Output

Upon successful execution, the action returns a URL to the generated image. The typical structure of the output is as follows:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/930a7ed6-7c07-442b-920b-fba34aabea91/3107c4e4-f3c2-43ea-a75c-9f7e7f6fe9ed.png"
]

Conceptual Usage Example (Python)

Here’s how you might structure a request to the Cognitive Actions API using Python:

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 = "685d444b-f4c4-4743-8e39-9c1bd246587d"  # Action ID for Generate Woodblock Style Image

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "an portrait of an astronaut in the style of TOK",
    "scheduler": "K_EULER",
    "outputCount": 1,
    "guidanceScale": 7.5,
    "applyWatermark": True,
    "negativePrompt": "",
    "promptStrength": 0.8,
    "refinementType": "no_refiner"
}

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 the code snippet above, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id is set to the ID of the Generate Woodblock Style Image action. The payload is constructed based on the input schema, and the request is sent to the API endpoint.

Conclusion

The tjrndll/woodprints Cognitive Actions provide an exciting opportunity for developers to enhance their applications with unique image generation capabilities. By integrating the Generate Woodblock Style Image action, you can create visually stunning images that resonate with users.

Consider exploring other potential use cases, such as creating promotional graphics, enhancing digital content, or even adding a creative touch to social media posts. Happy coding!

← Back to All Articles