image-generation

Create Stunning Custom Images Effortlessly with Stevekl

25 Apr 2025
Create Stunning Custom Images Effortlessly with Stevekl

In the realm of digital creativity, generating custom images tailored to specific prompts can be a game-changer for developers and artists alike. The Stevekl API offers a powerful Cognitive Action designed specifically for image generation, allowing users to create vivid and detailed images based on descriptive prompts. Whether you're looking to produce unique artwork, enhance marketing materials, or develop engaging content for social media, Stevekl simplifies the process, enabling rapid image creation without sacrificing quality.

With options for inpainting, aspect ratio adjustments, and various output formats, Stevekl empowers developers to create visually striking images that resonate with their audience. This flexibility is particularly beneficial for those in creative industries, game development, advertising, and content creation. By leveraging Stevekl, you can quickly generate high-quality images that meet your specific needs, thus saving time and resources.

Prerequisites

To get started with the Stevekl API, you will need a Cognitive Actions API key and a basic understanding of how to make API calls.

Generate Custom Image

The Generate Custom Image action within the Stevekl API allows you to create images based on descriptive prompts. This action is particularly useful for generating artistic representations and visual content that align closely with your creative vision. With options to customize details like aspect ratio, quality, and guidance scale, this action provides the flexibility to cater to various use cases.

Input Requirements

The input for this action is a structured request that includes:

  • prompt: A descriptive text that guides the image generation (required).
  • mask: An optional image mask for inpainting mode.
  • seed: An optional integer for reproducible generation.
  • model: Choose between 'dev' for detailed outputs or 'schnell' for faster results.
  • width and height: Specify dimensions if using a custom aspect ratio.
  • goFast: A boolean to enable speed optimization.
  • imageFormat: The desired format for the output image (e.g., webp, jpg, png).
  • outputCount: Specify how many images to generate (1 to 4).
  • guidanceScale: Controls the influence of the prompt on the generated image.
  • additional parameters such as LoRA scales, quality, and safety checks.

Expected Output

The output will be a URL pointing to the generated image in the specified format. For example, a successful request might return:

  • https://assets.cognitiveactions.com/invocations/222d550a-8d45-4bfb-bdc5-4e03509bc50f/490df0f7-6f45-49a6-83e8-59ecffe26b38.png

Use Cases for this Action

  • Creative Projects: Artists can use this action to generate unique illustrations or concepts based on specific themes or narratives.
  • Marketing and Advertising: Marketers can create tailored visuals for campaigns, enhancing engagement with custom images that align with brand messages.
  • Content Creation: Bloggers and social media managers can quickly generate eye-catching images to complement articles and posts, making content more visually appealing.
  • Game Development: Developers can produce concept art or textures for game assets, streamlining the creative process and reducing reliance on stock images.

```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 = "4fef45c0-2e47-487a-822f-6c9e562b5653" # Action ID for: Generate Custom Image

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "goFast": false,
  "prompt": "Photograph of STEVEKL quite fat walking in San Francisco trolley cars going up the hill, people walking on the street, a rainy day, foggy, cityscape, dark grey sky, hyper-realistic, realism, cinematic lighting, epic, cinematic composition, award-winning photography.",
  "imageFormat": "png",
  "outputCount": 1,
  "guidanceScale": 3,
  "mainLoraScale": 1,
  "outputQuality": 100,
  "promptStrength": 0,
  "imageMegapixels": "1",
  "imageAspectRatio": "1:1",
  "additionalLoraScale": 1,
  "inferenceStepsCount": 28
}

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 Stevekl API's image generation capabilities provide an efficient and effective solution for creating custom images tailored to your needs. With its flexibility and range of options, developers can easily produce high-quality visuals for various applications, from marketing to creative projects. As you explore the possibilities with Stevekl, consider integrating this powerful action into your workflow to enhance your creative output and streamline your visual content creation process.
← Back to All Articles