image-generation

Create Stunning Images from Text with Kandinsky 2.1

26 Apr 2025
Create Stunning Images from Text with Kandinsky 2.1

In the world of digital creativity, the ability to transform text prompts into vibrant images has become a game changer for developers and artists alike. The Kandinsky 2.1 service provides a powerful Cognitive Action that allows you to generate unique images based on descriptive text inputs. This capability not only streamlines the creative process but also introduces a new level of customization and specificity in image generation. Whether you are creating artwork, designing marketing materials, or enhancing user experiences, Kandinsky 2.1 can help you bring your ideas to life quickly and efficiently.

Prerequisites

To get started with Kandinsky 2.1, you will need a valid Cognitive Actions API key and a basic understanding of API calls to integrate this powerful tool into your applications.

Generate Image from Text

Purpose

The "Generate Image from Text" action utilizes the Kandinsky 2.1 model to create images based on your text prompts. It offers options for inpainting and text-guided transformations for existing images, enabling you to produce high-quality visuals tailored to your specifications. This action is categorized under image generation, making it an ideal choice for developers looking to enhance their projects with custom visuals.

Input Requirements

To utilize this action, you must provide the following inputs:

  • Task Type: Specify whether you want to generate an image from text (text2img), transform an existing image guided by text (text_guided_img2img), or inpaint an image (inpaint).
  • Prompt: A descriptive text prompt that defines the desired image.
  • Width & Height: Dimensions of the output image in pixels (ranging from 128 to 1024).
  • Strength: A value between 0 and 1 that indicates how much to transform the input image (only applicable for text_guided_img2img).
  • Guidance Scale: Controls adherence to the prompt, with a range from 1 to 20.
  • Negative Prompt: Specify any unwanted elements to avoid in the generated image.
  • Number of Outputs: Define how many images to produce (1 to 4).
  • Number of Steps Prior & Inference Steps: Control the denoising steps applied during the generation process.

Example input:

{
  "task": "text2img",
  "width": 256,
  "height": 256,
  "prompt": "A alien cheeseburger creature eating itself, claymation, cinematic, moody lighting",
  "strength": 0.3,
  "guidanceScale": 4,
  "negativePrompt": "low quality, bad quality",
  "numberOfOutputs": 1,
  "numberOfStepsPrior": 25,
  "numberOfInferenceSteps": 100
}

Expected Output

The expected output is a generated image that visually represents the input prompt. The output will be a URI link to the image created by the model.

Example output:

"https://assets.cognitiveactions.com/invocations/a3d1af56-abfc-4e57-9fae-b6de84de19b5/73d864f7-cc7f-4ccd-be21-b0d4638decba.png"

Use Cases for this Action

  • Creative Projects: Artists and designers can leverage this action to generate unique illustrations or concept art based on their ideas.
  • Content Creation: Content creators can quickly produce visuals for blogs, social media, or marketing campaigns, saving time and resources.
  • Game Development: Developers can create assets for games by generating images that fit specific themes or narratives.
  • Personalization: Businesses can offer personalized image generation services, allowing customers to create custom artwork based on their preferences.

```python
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "f36b31bc-6b54-4d97-b84a-ecb5e889506b" # Action ID for: Generate Image from Text

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "task": "text2img",
  "width": 256,
  "height": 256,
  "prompt": "A alien cheeseburger creature eating itself, claymation, cinematic, moody lighting",
  "strength": 0.3,
  "guidanceScale": 4,
  "negativePrompt": "low quality, bad quality",
  "numberOfOutputs": 1,
  "numberOfStepsPrior": 25,
  "numberOfInferenceSteps": 100
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")



## Conclusion
Kandinsky 2.1 empowers developers to create stunning images from text prompts, revolutionizing the way visuals can be generated and customized. With its flexibility and ease of use, this Cognitive Action can enhance various applications, from artistic endeavors to commercial projects. As you explore its capabilities, consider how you can integrate this powerful tool into your workflows to elevate your creative projects and deliver engaging user experiences. Embrace the future of image generation and unlock endless possibilities with Kandinsky 2.1!
← Back to All Articles