Create Stunning Zine-Style Portraits with the roblester/zine-style Cognitive Actions

22 Apr 2025
Create Stunning Zine-Style Portraits with the roblester/zine-style Cognitive Actions

In the world of digital content creation, the ability to generate unique and visually appealing images can set your application apart. The roblester/zine-style API offers powerful Cognitive Actions that allow developers to create zine-style portraits efficiently. These actions harness the capabilities of the SDXL model, fine-tuned with a custom synthetic dataset, enabling users to perform advanced image transformations and refinements. By leveraging these pre-built actions, developers can save time and focus on building innovative features rather than dealing with the complexities of image generation from scratch.

Prerequisites

To get started with the Cognitive Actions in the roblester/zine-style API, you'll need an API key from the Cognitive Actions platform. This key will be used for authentication by passing it in the headers of your API requests. Ensure you have the necessary libraries installed (like requests for Python) to facilitate making calls to the API.

Cognitive Actions Overview

Generate Zine-Style Portraits

The Generate Zine-Style Portraits action allows you to create unique zine-style portraits by specifying various parameters, including prompts, image dimensions, and refinement options. This action is categorized under image-generation.

Input

The following JSON schema outlines the inputs required for this action:

{
  "mask": "uri",
  "seed": "integer",
  "image": "uri",
  "width": "integer",
  "height": "integer",
  "prompt": "string",
  "refine": "string",
  "scheduler": "string",
  "loRAWeights": "string",
  "refineSteps": "integer",
  "guidanceScale": "number",
  "applyWatermark": "boolean",
  "negativePrompt": "string",
  "promptStrength": "number",
  "numberOfOutputs": "integer",
  "highNoiseFraction": "number",
  "loraAdditiveScale": "number",
  "disableSafetyChecker": "boolean",
  "numberOfInferenceSteps": "integer"
}

Here’s an example input payload:

{
  "width": 1024,
  "height": 1024,
  "prompt": "an illustration of a woman on the Surface of the Moon (in the style of TOK),",
  "refine": "no_refiner",
  "scheduler": "K_EULER_ANCESTRAL",
  "guidanceScale": 7.5,
  "applyWatermark": true,
  "negativePrompt": "text, watermark",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "highNoiseFraction": 0.8,
  "loraAdditiveScale": 0.9,
  "numberOfInferenceSteps": 50
}

Output

When this action is executed successfully, it typically returns an array of URLs pointing to the generated images. Here’s an example of the output:

[
  "https://assets.cognitiveactions.com/invocations/8b1e1f0e-2553-4a6d-b05b-8cb5a18dfc42/f3830fe0-1696-4fee-a2d7-58605427394b.png"
]

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the Generate Zine-Style Portraits action:

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 = "31c01b1a-bb5b-401a-b556-47916191bf5d"  # Action ID for Generate Zine-Style Portraits

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "an illustration of a woman on the Surface of the Moon (in the style of TOK),",
    "refine": "no_refiner",
    "scheduler": "K_EULER_ANCESTRAL",
    "guidanceScale": 7.5,
    "applyWatermark": True,
    "negativePrompt": "text, watermark",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "highNoiseFraction": 0.8,
    "loraAdditiveScale": 0.9,
    "numberOfInferenceSteps": 50
}

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 constructed based on the required JSON schema, and the request is sent to the hypothetical endpoint.

Conclusion

The roblester/zine-style Cognitive Actions provide a powerful toolset for developers looking to generate unique zine-style portraits. With features like img2img transformations and fine control over output parameters, integrating these actions into your applications can enhance user experience and creativity. Consider exploring additional use cases, such as integrating these images into a creative platform or using them to generate content for social media. Happy coding!

← Back to All Articles