Generate Stunning Images with pharc1/akira Cognitive Actions

24 Apr 2025
Generate Stunning Images with pharc1/akira Cognitive Actions

In today's digital landscape, the ability to generate high-quality images programmatically can be a game-changer for developers. The pharc1/akira spec offers a powerful set of Cognitive Actions that enable seamless image generation based on text prompts and customizable parameters. By utilizing these pre-built actions, developers can quickly integrate sophisticated image synthesis capabilities into their applications without diving deep into complex algorithms.

Prerequisites

Before you dive into using the Cognitive Actions from the pharc1/akira spec, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic understanding of RESTful concepts and JSON format.
  • A Python environment set up with the requests library for making API calls.

For authentication, you'll typically pass your API key in the headers of your requests.

Cognitive Actions Overview

Generate Image with Mask and Seed Options

This action generates images using a specified prompt, image mask, and various parameters such as image dimensions, output quality, and LoRA intensity. The operation supports fast generation mode and multiple output formats, optimizing inference with either the 'dev' or 'schnell' model for efficient image synthesis.

Input

The input schema for this action is defined as follows:

  • prompt (required): The text prompt that guides the image generation. Including specific trigger words can enhance the output.
  • mask (optional): An image mask for inpainting mode.
  • seed (optional): A random seed for reproducible generation.
  • model (optional): Specifies the inference model; defaults to "dev".
  • width (optional): The width of the generated image (256-1440).
  • height (optional): The height of the generated image (256-1440).
  • fastMode (optional): Enable faster predictions optimized for speed.
  • megapixels (optional): Defines the approximate number of megapixels.
  • aspectRatio (optional): Sets the aspect ratio of the generated image.
  • outputFormat (optional): Specifies the format of the output image (webp, jpg, png).
  • guidanceScale (optional): Adjusts the guidance scale for the diffusion process.
  • numberOfOutputs (optional): The number of outputs to generate (1-4).
  • numberOfInferenceSteps (optional): The number of denoising steps (1-50).

Here is an example of the input JSON payload:

{
  "model": "dev",
  "prompt": "aki Fantasy, A mystical, cosmic scene bathed in shades of deep violet and purple. The name 'Akira' is formed from a swirling vortex...",
  "fastMode": false,
  "megapixels": "1",
  "aspectRatio": "1:1",
  "outputFormat": "png",
  "guidanceScale": 2.01,
  "loraIntensity": 1,
  "outputQuality": 100,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 28,
  "additionalLoraIntensity": 1
}

Output

The action typically returns an array containing the URLs of the generated images. For instance:

[
  "https://assets.cognitiveactions.com/invocations/527018ad-b047-486b-9ce3-1df9f324ed5e/61790bfb-2dca-41f2-b765-6e0b55866ddc.png"
]

Conceptual Usage Example (Python)

Here’s how a developer might structure their code to call this 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 = "43329f40-69a5-4302-bc6a-b7a829660d6e" # Action ID for Generate Image with Mask and Seed Options

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "aki Fantasy, A mystical, cosmic scene bathed in shades of deep violet and purple. The name 'Akira' is formed from a swirling vortex...",
    "fastMode": False,
    "megapixels": "1",
    "aspectRatio": "1:1",
    "outputFormat": "png",
    "guidanceScale": 2.01,
    "loraIntensity": 1,
    "outputQuality": 100,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 28,
    "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 YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID for generating images is hardcoded, and the input payload is constructed based on the required fields.

Conclusion

By leveraging the pharc1/akira Cognitive Actions, developers can unlock powerful image generation capabilities tailored to their applications. Whether you're creating fantasy artwork, marketing visuals, or enhancing user experiences, these actions provide a flexible and efficient way to integrate advanced image synthesis into your projects. Explore further possibilities by experimenting with different prompts and parameters to achieve stunning visual outputs!

← Back to All Articles