Generate Stunning Images with Stability AI's Diffusion Cognitive Actions

24 Apr 2025
Generate Stunning Images with Stability AI's Diffusion Cognitive Actions

In the realm of artificial intelligence, generating imagery from textual descriptions has gained significant traction. The stability-ai/stable-diffusion API offers a powerful toolset for developers looking to integrate advanced image generation capabilities into their applications. This article will delve into the Cognitive Actions provided by this API, specifically focusing on how to generate high-quality, photo-realistic images from text prompts. By using these pre-built actions, developers can streamline their workflow and deliver enhanced visual content effortlessly.

Prerequisites

Before you begin integrating the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic understanding of JSON and HTTP requests.
  • A Python development environment set up with the requests library installed.

Authentication typically involves passing your API key in the request headers, ensuring secure access to the action executions.

Cognitive Actions Overview

Generate Photo-Realistic Image from Text

The Generate Photo-Realistic Image from Text action leverages a diffusion model called Stable Diffusion to create stunning images based on textual prompts. This action supports flexible image sizes and is optimized for speed and dynamic resizing, making it a powerful tool for developers in various domains such as gaming, content creation, and marketing.

Input

The action accepts the following input parameters:

  • prompt (string): Guides the image generation. Default is "a vision of paradise. unreal engine".
  • width (integer): Width of the generated image in pixels (default: 768, must be a multiple of 64).
  • height (integer): Height of the generated image in pixels (default: 768, must be a multiple of 64).
  • seed (integer, optional): Random seed for generation. Leave blank to randomize.
  • scheduler (string): Specifies the scheduler to use during generation (default: "DPMSolverMultistep").
  • guidanceScale (number): Affects the influence of the prompt on the output (default: 7.5, range: 1 to 20).
  • negativePrompt (string, optional): Elements to exclude from the generated image.
  • numberOfOutputs (integer): Total number of images to produce (default: 1, range: 1 to 4).
  • numberOfInferenceSteps (integer): Denoising steps in the generation process (default: 50, range: 1 to 500).

Example Input:

{
  "prompt": "an astronaut riding a horse on mars, hd, dramatic lighting",
  "scheduler": "K_EULER",
  "guidanceScale": 7.5,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 50
}

Output

Upon successful execution, the action returns an array of URLs pointing to the generated images. Here’s an example of the output:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/c73cd2bf-c161-4fa4-bbdd-898ed4d1c4a2/3a05bc08-af95-4300-8457-dc8cae3d3754.png"
]

Conceptual Usage Example (Python)

Here’s how you might call this action using Python. This snippet demonstrates how to structure the input payload and make the request:

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 = "bd116eed-d944-4c5e-a275-3fd08dba7495"  # Action ID for Generate Photo-Realistic Image from Text

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "an astronaut riding a horse on mars, hd, dramatic lighting",
    "scheduler": "K_EULER",
    "guidanceScale": 7.5,
    "numberOfOutputs": 1,
    "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}
    )
    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 the placeholder for your API key and adjust the endpoint as necessary. The action_id corresponds to the specific action for generating images. The input payload is structured according to the action's schema.

Conclusion

The stability-ai/stable-diffusion API's Cognitive Actions provide a robust solution for developers looking to create visually appealing content from textual descriptions. With the ability to customize image dimensions, control the generation process, and influence the output through guidance scales and prompts, these actions open up a world of creative possibilities.

Consider experimenting with different prompts and settings to fully harness the capabilities of this powerful image generation tool. Happy coding!

← Back to All Articles