Generate Stunning Pixel Art with lucataco/pixart-sigma-900m Cognitive Actions

22 Apr 2025
Generate Stunning Pixel Art with lucataco/pixart-sigma-900m Cognitive Actions

The lucataco/pixart-sigma-900m specification offers a powerful tool for developers to create high-quality pixel art images based on user-defined text prompts. Leveraging the capabilities of the PixArt Sigma 900M model, this API provides enhanced detail and customization options, making it an excellent choice for anyone looking to incorporate artistic image generation into their applications. With features such as seed control, image dimension specifications, and guidance scaling, you can tailor the output to fit a variety of creative needs.

Prerequisites

Before using the Cognitive Actions under the lucataco/pixart-sigma-900m spec, ensure you have:

  • An API key for the Cognitive Actions platform. This key will be used to authenticate your requests.
  • Familiarity with JSON payload structures as the input and output will be in JSON format.

To authenticate your requests, you will typically include the API key in the headers of your HTTP requests.

Cognitive Actions Overview

Generate Image with PixArt Sigma 900M

The Generate Image with PixArt Sigma 900M action enables the creation of pixel art images based on specific text prompts. By utilizing a model with 900 million parameters, this action enhances the quality of generated images and offers various customization features.

Input

The input for this action consists of several fields, allowing developers to specify the characteristics of the image to be generated:

  • seed (integer, optional): A random seed to initiate the generation process. Leave blank to use a randomized seed.
  • width (integer, optional): The width of the output image in pixels. Default is 1024 pixels.
  • height (integer, optional): The height of the output image in pixels. Default is 1024 pixels.
  • prompt (string, required): The main input prompt that guides the image generation. Use descriptive language to influence the style and content.
  • guidanceScale (number, optional): A scale for classifier-free guidance, affecting adherence to the prompt (1 to 50). Default value is 3.
  • negativePrompt (string, optional): Specifies elements to avoid in the output image.
  • numInferenceSteps (integer, optional): The number of denoising steps during generation, impacting detail and processing time (1 to 100). Default is 20 steps.

Example Input:

{
  "width": 1024,
  "height": 1024,
  "prompt": "high quality pixel art, a pixel art silhouette of an anime space-themed girl in a space-punk steampunk style, lying in her bed by the window of a spaceship, smoking, with a rustic feel. The image should embody epic portraiture and double exposure, featuring an isolated landscape visible through the window. The colors should primarily be dynamic and action-packed, with a strong use of negative space. The entire artwork should be in pixel art style, emphasizing the characters shape and set against a white background. Silhouette",
  "guidanceScale": 3,
  "negativePrompt": "",
  "numInferenceSteps": 20
}

Output

Upon successful execution, the action returns a URL to the generated pixel art image. Here’s a sample output:

Example Output:

https://assets.cognitiveactions.com/invocations/3ff5d366-c3be-4170-bcb5-d62f40a95703/8dadf6b0-fd03-41d6-8300-db1f173f2940.jpg

Conceptual Usage Example (Python)

Here’s how you might call the Generate Image with PixArt Sigma 900M 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 = "faaa3a6a-df3b-4b67-bae5-9eca82088b63"  # Action ID for Generate Image with PixArt Sigma 900M

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "high quality pixel art, a pixel art silhouette of an anime space-themed girl in a space-punk steampunk style, lying in her bed by the window of a spaceship, smoking, with a rustic feel. The image should embody epic portraiture and double exposure, featuring an isolated landscape visible through the window. The colors should primarily be dynamic and action-packed, with a strong use of negative space. The entire artwork should be in pixel art style, emphasizing the characters shape and set against a white background. Silhouette",
    "guidanceScale": 3,
    "negativePrompt": "",
    "numInferenceSteps": 20
}

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 snippet, you will replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID and input payload are structured according to the requirements outlined above. The endpoint URL is hypothetical and should be replaced with the actual URL provided by the Cognitive Actions platform.

Conclusion

The lucataco/pixart-sigma-900m Cognitive Actions provide a powerful way to generate pixel art images tailored to your specifications. By utilizing the various input options, developers can create unique and engaging visual content for their applications. As you explore the capabilities of this action, consider how it could enhance user experiences in gaming, digital art, and beyond!

← Back to All Articles