Generate Stunning Visuals with the Anillustrious-v4 Cognitive Action

23 Apr 2025
Generate Stunning Visuals with the Anillustrious-v4 Cognitive Action

In the realm of artificial intelligence, image generation has taken a prominent role, enabling developers to create stunning visuals from textual prompts. The Anillustrious-v4 Cognitive Action offers this capability by utilizing a sophisticated model to generate high-quality images based on your detailed descriptions. This blog post will guide you through the integration of the Generate Image Using Anillustrious-v4 action, demonstrating its features, input requirements, and practical usage.

Prerequisites

Before you get started with the Anillustrious-v4 Cognitive Action, ensure you have the following:

  • An API key from the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON structure and Python for implementing the API calls.

Authentication typically involves passing your API key in the request headers, allowing you to securely access the Cognitive Actions.

Cognitive Actions Overview

Generate Image Using Anillustrious-v4

The Generate Image Using Anillustrious-v4 action allows you to create high-quality images based on detailed textual prompts. It offers various customization options, including image dimensions, generation steps, and advanced prompt management techniques.

Input

The input schema for this action includes multiple fields, allowing extensive customization. Here’s a breakdown of the required and optional parameters:

  • seed: (integer) Seed for generation; set to -1 for a random seed. Defaults to -1.
  • model: (string) Select the model for generation; default is "Anillustrious-v4".
  • steps: (integer) Number of steps for the generation process (1-100); default is 16.
  • width: (integer) Width of the generated image in pixels (1-4096); default is 1024.
  • height: (integer) Height of the generated image in pixels (1-4096); default is 1024.
  • prompt: (string) Textual prompt for image generation using Compel weighting syntax; defaults to a descriptive example.
  • refiner: (boolean) Enable or disable the image refiner; default is false.
  • upscale: (string) Select the upscale factor; options are "Original", "x2", "x4", "x8"; default is "Original".
  • negativeTextPrompt: (string) Elements to avoid in the image; uses Compel weighting syntax.
  • additional parameters: There are several other parameters available for advanced control, such as refiner intensity, VAE selection, and scheduler algorithm.

Here’s an example input JSON payload:

{
  "seed": -1,
  "model": "Anillustrious-v4",
  "steps": 30,
  "width": 1024,
  "height": 1024,
  "prompt": "\nfrom above,street\n1girl, dark-purple short hair, purple eyes, medium breasts, cleavage, casual clothes, smile",
  "refiner": false,
  "upscale": "Original",
  "negativeTextPrompt": "nsfw, naked"
}

Output

The action typically returns a URL pointing to the generated image. Here’s an example of the expected output:

[
  "https://assets.cognitiveactions.com/invocations/51945fbe-ac69-458e-87dc-cc86feaa2cb0/7206ca4b-40b7-4a60-8e32-4e7d3cf42d99.png"
]

Conceptual Usage Example (Python)

Here’s how you might call the Generate Image Using Anillustrious-v4 action 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 = "b5ab9b1e-56be-4ed4-9809-fdc3ecd18d71"  # Action ID for Generate Image Using Anillustrious-v4

# Construct the input payload based on the action's requirements
payload = {
    "seed": -1,
    "model": "Anillustrious-v4",
    "steps": 30,
    "width": 1024,
    "height": 1024,
    "prompt": "\nfrom above,street\n1girl, dark-purple short hair, purple eyes, medium breasts, cleavage, casual clothes, smile",
    "refiner": False,
    "upscale": "Original",
    "negativeTextPrompt": "nsfw, naked"
}

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}")

This code snippet demonstrates how to set up the request, including the input JSON payload and headers. Remember, the endpoint URL and action ID are hypothetical and should be replaced with actual values from your environment.

Conclusion

The Generate Image Using Anillustrious-v4 Cognitive Action is a powerful tool for developers looking to create high-quality images from textual descriptions. With its extensive customization options, you can tailor the image generation process to meet your specific needs. Whether you're building a creative application or enhancing your existing projects, integrating this action can significantly elevate your visual content creation.

Start experimenting with your prompts and explore the endless possibilities of image generation!

← Back to All Articles