Create Stunning Images with the hadasadler/talsh Cognitive Actions

21 Apr 2025
Create Stunning Images with the hadasadler/talsh Cognitive Actions

In the world of application development, integrating powerful image generation capabilities can significantly enhance user experiences. The hadasadler/talsh API offers a robust Cognitive Action designed specifically for generating high-quality images based on textual prompts. This action provides flexibility in terms of image quality, format, and generation speed, making it an excellent choice for developers looking to incorporate advanced visual content into their applications.

Prerequisites

Before you start using the Cognitive Actions from the hadasadler/talsh API, you will need to ensure you have the following:

  • API Key: Sign up for the Cognitive Actions platform and obtain your API key.
  • Network Access: Ensure your application has the capability to make HTTP requests to the Cognitive Actions API.

For authentication, you will typically pass your API key in the request headers, allowing you to securely access the available actions.

Cognitive Actions Overview

Generate Image with Prediction

The Generate Image with Prediction action allows you to create a high-quality image based on a specified text prompt. With options for different models and image generation modes, this action is versatile for various use cases, from artistic creations to tailored imagery for applications.

Input

The input for this action requires a JSON object that includes several fields. Below are the key properties:

  • prompt (required): The textual description for the image you want to generate.
  • model (optional): Choose between "dev" (more detailed) or "schnell" (faster).
  • aspectRatio (optional): Specifies the desired aspect ratio of the generated image.
  • imageFormat (optional): Choose the output image format (webp, jpg, png).
  • outputCount (optional): Number of images to generate (1 to 4).
  • imageQuality (optional): Quality setting for the output image (0 to 100).
  • denoisingSteps (optional): Number of steps for generating the image details (1 to 50).
  • enableFastMode (optional): Boolean to toggle fast generation mode.

Here’s an example input JSON payload:

{
  "model": "dev",
  "prompt": "talsh  man looking to the camera",
  "aspectRatio": "16:9",
  "imageFormat": "jpg",
  "outputCount": 1,
  "imageQuality": 80,
  "loraIntensity": 1,
  "denoisingSteps": 28,
  "enableFastMode": false,
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "guidanceMultiplier": 3,
  "additionalLoraIntensity": 1
}

Output

The output of this action typically returns a URL pointing to the generated image. Here’s an example of what you might receive:

[
  "https://assets.cognitiveactions.com/invocations/1313233b-5adf-40a6-9a10-bb852b1a211e/842eb705-9bf2-4164-adc6-30dab2156b84.jpg"
]

Conceptual Usage Example (Python)

The following Python code snippet demonstrates how to call the Generate Image with Prediction action using the Cognitive Actions API:

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 = "bad7c39d-77ec-43c8-a93a-53fb35ada7b6"  # Action ID for Generate Image with Prediction

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "talsh  man looking to the camera",
    "aspectRatio": "16:9",
    "imageFormat": "jpg",
    "outputCount": 1,
    "imageQuality": 80,
    "loraIntensity": 1,
    "denoisingSteps": 28,
    "enableFastMode": false,
    "promptStrength": 0.8,
    "imageMegapixels": "1",
    "guidanceMultiplier": 3,
    "additionalLoraIntensity": 1
}

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 example, replace the placeholder YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the Generate Image with Prediction action, and the payload is structured according to the required input schema.

Conclusion

The hadasadler/talsh Cognitive Action for image generation provides developers with an intuitive and powerful tool to create stunning visuals based on simple text prompts. By leveraging the flexibility in model selection and output configurations, you can tailor the image generation process to suit your specific application needs. Explore integrating this action into your projects and unlock new creative possibilities!

← Back to All Articles