Enhance Image Generation with Cognitive Actions in datacte/proteus-v0.4-lightning

24 Apr 2025
Enhance Image Generation with Cognitive Actions in datacte/proteus-v0.4-lightning

In today's fast-paced digital landscape, the ability to generate captivating images can give your application a significant edge. The datacte/proteus-v0.4-lightning API offers a powerful Cognitive Action designed to enhance stylistic capabilities in image generation. This action, inspired by models like Midjourney, excels in rendering intricate facial features and lifelike textures across various styles, including surrealism, anime, and cartoon. By integrating this action, developers can create stunning visuals that captivate users without needing intricate prompt understanding.

Prerequisites

To get started with integrating the Cognitive Actions from the datacte/proteus-v0.4-lightning API, you will need:

  • An API key to access the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests and handling JSON data.

Authentication typically involves passing your API key in the headers of your requests.

Cognitive Actions Overview

Enhance Style with ProteusV0.4

The Enhance Style with ProteusV0.4 action is aimed at developers looking to enhance their image generation capabilities. It allows the generation of high-quality images based on textual prompts, while also providing options for customization through various parameters.

Input

The input for this action is structured as follows:

  • mask (string, optional): URL of the input mask for inpaint mode. Black areas will be preserved; white areas will be inpainted.
  • seed (integer, optional): Random seed for reproducibility.
  • image (string, optional): URL of the input image for img2img or inpaint modes.
  • width (integer, default: 1024): Width of the output image in pixels.
  • height (integer, default: 1024): Height of the output image in pixels.
  • prompt (string, default: "3 fish in a fish tank wearing adorable outfits, best quality, hd"): Text prompt to guide image generation.
  • scheduler (string, default: "K_EULER_ANCESTRAL"): Scheduler algorithm for the image generation process.
  • guidanceScale (number, default: 2): Scale factor for classifier-free guidance.
  • applyWatermark (boolean, default: true): Whether to apply a watermark to the generated image.
  • negativePrompt (string, default: "nsfw, bad quality..."): Negative prompt for specifying unwanted features.
  • promptStrength (number, default: 0.8): Degree to which the input prompt affects img2img or inpaint modes.
  • numberOfOutputs (integer, default: 1): Specifies the number of images to generate (maximum 4).
  • disableSafetyChecker (boolean, default: false): Option to disable the safety checker.
  • numberOfInferenceSteps (integer, default: 8): Specifies the number of denoising steps during image generation.

Here’s a practical example of the JSON payload needed to invoke this action:

{
  "width": 1024,
  "height": 1024,
  "prompt": "3 fish in a fish tank wearing adorable outfits, best quality, hd",
  "scheduler": "K_EULER_ANCESTRAL",
  "guidanceScale": 2,
  "applyWatermark": true,
  "negativePrompt": "nsfw, bad quality, bad anatomy, worst quality, low quality...",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 8
}

Output

Upon successful execution, the action typically returns a URL pointing to the generated image. Here’s an example of the output you can expect:

[
  "https://assets.cognitiveactions.com/invocations/5df2edcf-9e62-42cb-86a3-92222606977e/e9339502-5471-4384-bad3-a2dae7f9b14a.png"
]

Conceptual Usage Example (Python)

Here’s a conceptual example of how you might call the Enhance Style with ProteusV0.4 action using Python. This example demonstrates how to structure the input JSON payload correctly.

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 = "e9078e80-7f22-4f1b-8b24-1ea40167c736"  # Action ID for Enhance Style with ProteusV0.4

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "3 fish in a fish tank wearing adorable outfits, best quality, hd",
    "scheduler": "K_EULER_ANCESTRAL",
    "guidanceScale": 2,
    "applyWatermark": True,
    "negativePrompt": "nsfw, bad quality, bad anatomy, worst quality, low quality...",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 8
}

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, make sure to replace the placeholder for the API key with your actual key. The action ID and payload should be structured as shown.

Conclusion

The Enhance Style with ProteusV0.4 action from the datacte/proteus-v0.4-lightning API offers developers a robust way to create visually stunning images. By utilizing the various parameters available, you can customize your image generation to suit your application's needs. We encourage you to explore and integrate this action into your projects, unlocking the potential for enhanced creativity and user engagement.

← Back to All Articles