Generate Stunning Images with kwiktwikteam/xyz Cognitive Actions

22 Apr 2025
Generate Stunning Images with kwiktwikteam/xyz Cognitive Actions

In the realm of AI and image generation, the kwiktwikteam/xyz API offers powerful Cognitive Actions that allow developers to create stunning custom images with ease. The primary action available in this API is designed for image-to-image transformations and inpainting, providing significant control over various image parameters. By leveraging these pre-built actions, developers can integrate sophisticated image generation capabilities into their applications without extensive machine learning expertise.

Prerequisites

Before you can start using the Cognitive Actions, you'll need to ensure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON structure and how to make API requests.

Authentication typically involves passing the API key in the headers of your HTTP requests, which will allow you to access the Cognitive Actions securely.

Cognitive Actions Overview

Generate Custom Images

The Generate Custom Images action allows you to create tailored images by providing specific prompts and parameters. This action is categorized under image-generation and offers a variety of options for customization.

  • Purpose: Generate customized images using image-to-image transformation or inpainting based on the provided prompts and parameters.

Input

The input for the Generate Custom Images action requires a JSON object with several optional fields. Below is the schema with an example input:

{
  "prompt": "XYZ in front of tower of paris",
  "accelerate": false,
  "megaPixels": "1",
  "aspectRatio": "9:16",
  "imageFormat": "webp",
  "imageQuality": 80,
  "guidanceScale": 3,
  "mainLoraScale": 1,
  "selectedModel": "dev",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "numInferenceSteps": 28,
  "additionalLoraScale": 1
}
  • Required Field:
    • prompt: A text string that describes the image you want to generate.
  • Optional Fields:
    • mask: URI for an image mask if using inpainting.
    • seed: An integer seed for consistent output across runs.
    • image: URI for an input image if inpainting or image-to-image is specified.
    • width and height: Control dimensions if aspectRatio is set to custom.
    • accelerate: Boolean to enable faster model execution.
    • megaPixels: String for the approximate resolution.
    • aspectRatio: String defining the image's aspect ratio.
    • imageFormat: String for the output image format.
    • imageQuality: Integer for output quality level.
    • Other parameters like guidanceScale, numberOfOutputs, and numInferenceSteps allow further customization of the generated image.

Output

The output of the Generate Custom Images action will typically be a JSON array containing URLs to the generated images. Here’s an example output:

[
  "https://assets.cognitiveactions.com/invocations/e0687a26-957b-4911-b63b-6d8244f46163/9982a7fd-1b19-4e44-a2e9-04313ea9702c.webp"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python snippet demonstrating how to call the Generate Custom Images action using a hypothetical endpoint:

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 = "d028d46f-17bb-4464-96f2-94df585d5a3b"  # Action ID for Generate Custom Images

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "XYZ in front of tower of paris",
    "accelerate": False,
    "megaPixels": "1",
    "aspectRatio": "9:16",
    "imageFormat": "webp",
    "imageQuality": 80,
    "guidanceScale": 3,
    "mainLoraScale": 1,
    "selectedModel": "dev",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "numInferenceSteps": 28,
    "additionalLoraScale": 1
}

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, you will see the action ID and the input payload being used to make a request to the Cognitive Actions API. The endpoint URL and request structure presented here are illustrative and should be customized as per your actual implementation.

Conclusion

The kwiktwikteam/xyz Cognitive Actions provide a robust and flexible solution for image generation, enabling developers to create customized images efficiently. By understanding the capabilities of the Generate Custom Images action and how to structure your requests, you can unlock a variety of creative possibilities in your applications. As a next step, consider experimenting with different prompts and parameters to see the diverse outputs that can be generated!

← Back to All Articles