Generate Stunning Visuals with ai-forever/kandinsky-2 Cognitive Actions

22 Apr 2025
Generate Stunning Visuals with ai-forever/kandinsky-2 Cognitive Actions

Introduction

The ai-forever/kandinsky-2 API offers powerful capabilities for image generation, enabling developers to create high-quality images from textual descriptions. Utilizing the advanced Kandinsky 2.1 model, this service allows for intricate image manipulation based on user-defined prompts. With a focus on enhancing visual performance through extensive training, these pre-built actions streamline the process of turning ideas into vivid images, making it easier to integrate creative functionalities into applications.

Prerequisites

Before you start using the Cognitive Actions from the ai-forever/kandinsky-2 API, ensure you have the following:

  • An API key for authentication. This will be necessary to access the Cognitive Actions platform.
  • Familiarity with JSON, as input and output will be structured in this format.

To authenticate, you typically include your API key in the headers of your requests. Here's a conceptual structure for your API call:

Authorization: Bearer YOUR_COGNITIVE_ACTIONS_API_KEY
Content-Type: application/json

Cognitive Actions Overview

Generate Image from Text

The Generate Image from Text action utilizes the Kandinsky 2.1 model to create stunning images based on text prompts. This action is categorized under image-generation, allowing for high-quality visuals driven by user-defined descriptions.

Input

This action requires a structured input in JSON format. Below is the schema for the input fields:

  • prompt (string): The textual description guiding the image generation. Default is "red cat, 4k photo".
  • scheduler (string): The algorithm used for sampling. Default is "p_sampler".
  • priorSteps (string): Number of prior steps in the generation process. Default is "5".
  • priorCfScale (integer): Scaling factor for classifier-free guidance. Default is 4.
  • guidanceScale (number): Strength of classifier-free guidance, ranging from 1 to 20. Default is 4.
  • numInferenceSteps (integer): Total number of denoising steps, ranging from 1 to 500. Default is 50.
  • seed (integer, optional): Sets the random seed for generation. Leave blank for randomization.
  • width (integer, optional): Width of the output image (256, 288, 432, 512, 576, 768, or 1024). Default is 512.
  • height (integer, optional): Height of the output image (256, 288, 432, 512, 576, 768, or 1024). Default is 512.
  • batchSize (integer, optional): Number of outputs to generate in a batch (1 to 4). Default is 1.
  • outputFormat (string, optional): Format of the output images (webp, jpg, or png). Default is webp.
  • outputQuality (integer, optional): Quality of the output images (0 to 100). Default is 80.

Here’s an example of the JSON payload for this action:

{
  "prompt": "red cat, 4k photo",
  "scheduler": "p_sampler",
  "priorSteps": "5",
  "priorCfScale": 4,
  "guidanceScale": 4,
  "numInferenceSteps": 100
}

Output

The action returns a list of URLs pointing to the generated images. Below is an example of a typical output:

[
  "https://assets.cognitiveactions.com/invocations/2d201735-caa5-4d81-b974-46b3e33bb93a/604252fc-4205-47de-8388-06d2f030d55c.webp"
]

Conceptual Usage Example (Python)

Here's how you might call this action using Python, focusing on structuring the input payload correctly:

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 = "2bc29324-df65-48cc-a83b-7468e85c18fb" # Action ID for Generate Image from Text

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "red cat, 4k photo",
    "scheduler": "p_sampler",
    "priorSteps": "5",
    "priorCfScale": 4,
    "guidanceScale": 4,
    "numInferenceSteps": 100
}

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 and ensure that the endpoint URL matches the one provided by the Cognitive Actions platform. The payload is constructed according to the requirements of the action.

Conclusion

The ai-forever/kandinsky-2 Cognitive Actions provide a robust solution for developers looking to integrate sophisticated image generation capabilities into their applications. By utilizing the Generate Image from Text action, you can transform simple text prompts into captivating visuals, significantly enhancing user engagement and creative expression. Consider experimenting with different prompts and configurations to fully explore the potential of this powerful API. Happy coding!

← Back to All Articles