Create Stunning Images with gulpdiseno/fajitas Cognitive Actions

23 Apr 2025
Create Stunning Images with gulpdiseno/fajitas Cognitive Actions

In today's digital landscape, the ability to generate high-quality images programmatically can significantly enhance applications, whether for marketing, social media, or e-commerce. The gulpdiseno/fajitas API provides a robust set of Cognitive Actions that allow developers to create images with customizable parameters. This blog post will guide you through the capabilities of the Generate Image with Custom Parameters action, enabling you to leverage its features to create unique images tailored to your needs.

Prerequisites

Before diving into the integration of the gulpdiseno/fajitas actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic understanding of JSON and RESTful API structures.
  • A development environment set up for making HTTP requests, such as Python with the requests library.

Authentication typically involves passing your API key in the request headers. This will allow you to securely call the actions and utilize their capabilities effectively.

Cognitive Actions Overview

Generate Image with Custom Parameters

The Generate Image with Custom Parameters action is designed to create images based on a variety of input parameters, including aspect ratio, dimensions, and even specific models optimized for different inference steps. This action supports inpainting and image-to-image transformations, providing extensive customization options for developers.

Input

The action requires a JSON payload with the following schema:

  • prompt (string, required): The guiding text for image generation.
  • mask (string, optional): URI for an image mask in inpainting mode.
  • seed (integer, optional): Seed for random number generation.
  • image (string, optional): URI for an input image used in transformations.
  • model (string, optional): Model selection (dev or schnell, default is dev).
  • width (integer, optional): Width of the generated image in pixels (256-1440).
  • height (integer, optional): Height of the generated image in pixels (256-1440).
  • loraScale (number, optional): Intensity for applying primary LoRA (default 1).
  • megapixels (string, optional): Approximate number of megapixels for the image.
  • numOutputs (integer, optional): Number of output images to generate (1-4).
  • aspectRatio (string, optional): Specifies the aspect ratio (default is 1:1).
  • exportFormat (string, optional): Output image format (default is webp).
  • guidanceScale (number, optional): Scale factor for the diffusion process (default 3).
  • outputQuality (integer, optional): Image quality (0-100, default 80).
  • enableFastMode (boolean, optional): Activate optimized model for speed (default false).
  • extraLoraScale (number, optional): Intensity for applying additional LoRA (default 1).
  • promptStrength (number, optional): Strength of the prompt when using img-to-img generation (default 0.8).
  • numInferenceSteps (integer, optional): Number of steps for denoising (default 28).
  • disableSafetyChecker (boolean, optional): Toggle the safety checker (default false).

Here is an example input payload for the action:

{
  "model": "dev",
  "prompt": "The FAJT package in a grocery store",
  "loraScale": 1,
  "megapixels": "1",
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "exportFormat": "webp",
  "guidanceScale": 3,
  "outputQuality": 80,
  "enableFastMode": false,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 28
}

Output

The action returns a JSON array containing URLs of the generated images. Here’s an example of a typical output:

[
  "https://assets.cognitiveactions.com/invocations/b1c61102-68f7-4d64-8f6e-505e2211545a/beb1160f-c8cf-4b10-90d3-06655a5fcfda.webp"
]

Conceptual Usage Example (Python)

To call the Generate Image with Custom Parameters action, you can use the following Python code snippet. This demonstrates how to structure your input JSON payload and make a request to the hypothetical Cognitive Actions execution 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 = "000b3137-0332-439e-96df-0200b6a4800b"  # Action ID for Generate Image with Custom Parameters

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "The FAJT package in a grocery store",
    "loraScale": 1,
    "megapixels": "1",
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "exportFormat": "webp",
    "guidanceScale": 3,
    "outputQuality": 80,
    "enableFastMode": False,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "numInferenceSteps": 28
}

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}")

This code demonstrates how to set up an API call to generate an image. You simply need to replace the placeholders with your actual API key and action ID. The input payload is structured to match the requirements of the Generate Image with Custom Parameters action.

Conclusion

The gulpdiseno/fajitas Cognitive Actions provide developers with powerful tools for image generation, allowing for extensive customization and versatility. By integrating the Generate Image with Custom Parameters action into your applications, you can create unique, high-quality images that enhance user engagement.

Explore the possibilities, and consider how you might incorporate these actions into your projects to elevate your application's visual appeal!

← Back to All Articles