image-generation

Generate Stunning Images from Text Descriptions with Slam

26 Apr 2025
Generate Stunning Images from Text Descriptions with Slam

In today's digital landscape, the ability to create compelling visuals from textual descriptions is invaluable. The Slam service offers a powerful Cognitive Action called "Generate Image Prediction," which allows developers to seamlessly convert text prompts into high-quality images. This functionality not only speeds up the creative process but also simplifies the task of generating custom visuals tailored to specific needs.

Imagine being able to create illustrations for articles, marketing materials, or even personal projects with just a few lines of text. This action is particularly beneficial for content creators, marketers, game developers, and anyone needing unique imagery without the hassle of manual design.

Prerequisites

To get started with Slam's Cognitive Actions, you will need an API key and a basic understanding of making API calls.

Generate Image Prediction

The "Generate Image Prediction" action is designed to create images based on a textual description while providing various customizable parameters. This action addresses the need for rapid image generation, eliminating the time-consuming process of traditional design methods.

Input Requirements

The input for this action is a JSON object that includes the following properties:

  • Prompt: A string describing the desired content (e.g., "A man with hoodie on, illustration").
  • Width: An integer specifying the image width in pixels (default: 1024, max: 2048).
  • Height: An integer specifying the image height in pixels (default: 1024, max: 2048).
  • Number of Images: An integer indicating how many images to generate (default: 1, max: 4).
  • Steps: An integer defining the number of denoising steps for quality (default: 4, max: 50).
  • Seed: An optional integer for reproducibility (default: randomized).
  • Negative Prompt: A string for elements to exclude from the image.
  • Guidance Scale: A number adjusting the guidance strength (default: 1).
  • Clip Layer Skip: An integer affecting the layers in the CLIP model (default: 0).
  • Expected Time of Arrival: A number controlling randomness in generation (default: 0).

Example Input:

{
  "seed": 1234,
  "steps": 4,
  "width": 1024,
  "height": 1024,
  "prompt": "A man with hoodie on, illustration",
  "clipLayerSkip": 0,
  "numberOfImages": 1,
  "guidanceScaleFactor": 1,
  "expectedTimeOfArrival": 0
}

Expected Output

The output will be a URL pointing to the generated image, allowing easy access and integration into projects.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/b013c98e-9696-4d74-844c-06727d99da4f/ff58bf2f-422d-4977-aaf7-41c3545b3734.png"
]

Use Cases for this Action

  • Content Creation: Quickly generate custom images for blogs, social media posts, or videos based on textual descriptions.
  • Marketing Materials: Design unique visuals for advertisements or promotional content without needing graphic design skills.
  • Game Development: Create concept art or character designs by describing them in words, speeding up the prototyping phase.
  • Personal Projects: Bring personal ideas to life by converting creative prompts into visuals for presentations or art projects.

```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 = "2a9e41c9-4423-4963-94c5-e419a9491c01" # Action ID for: Generate Image Prediction

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "seed": 1234,
  "steps": 4,
  "width": 1024,
  "height": 1024,
  "prompt": "A man with hoodie on, illustration",
  "clipLayerSkip": 0,
  "numberOfImages": 1,
  "guidanceScaleFactor": 1,
  "expectedTimeOfArrival": 0
}

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
The "Generate Image Prediction" action from Slam empowers developers to easily create stunning visuals from text prompts. By streamlining the image generation process, it opens up a world of possibilities for content creators, marketers, and developers alike. With customizable parameters ensuring flexibility, you can tailor outputs to meet your specific needs. As the next step, consider integrating this action into your applications to enhance visual storytelling and creativity.
← Back to All Articles