Unlock Image Generation Capabilities with the arietudo/lunavestl Cognitive Actions

22 Apr 2025
Unlock Image Generation Capabilities with the arietudo/lunavestl Cognitive Actions

In the rapidly evolving realm of artificial intelligence, the ability to generate images using customizable prompts and parameters has gained significant traction. The arietudo/lunavestl API offers robust Cognitive Actions designed specifically for this purpose, enabling developers to create stunning images through intuitive controls like image inpainting, aspect ratio configuration, and model selection. By leveraging these pre-built actions, developers can enhance their applications with powerful image generation capabilities without the need for extensive machine learning expertise.

Prerequisites

Before diving into the integration of the Cognitive Actions, ensure you have the following prerequisites in place:

  • API Key: You will need an API key for the Cognitive Actions platform to authenticate your requests.
  • Setup: Familiarity with making API requests, ideally using a programming language like Python.

For authentication, you will typically pass your API key in the request headers when invoking the actions.

Cognitive Actions Overview

Generate Image with Inpainting and Customization

The Generate Image with Inpainting and Customization action allows developers to create customized images by specifying parameters such as aspect ratio, image resolution, and format. It supports both image-to-image generation and inpainting modes, enabling flexible and speed-optimized image creation while ensuring reproducibility with integer seeds.

Input

The input for this action requires a JSON object with the following schema:

{
  "prompt": "Your descriptive prompt here",
  "image": "https://example.com/image.png",  // Optional for image-to-image mode
  "mask": "https://example.com/mask.png",  // Optional for inpainting mode
  "aspectRatio": "1:1",
  "width": 512,
  "height": 512,
  "seed": 42,
  "numOutputs": 1,
  ...
}

Example Input:

{
  "image": "https://replicate.delivery/pbxt/LqEfJlfZRn3Q75zJhC6rpoUlubLtbBXrAe1PpStwYkiRFvaD/replicate-prediction-ads3p6xg45rj20cjprs9abwstc.png",
  "prompt": "lunavestl vestida como Blanca Nieves, tiene piel sin brillo y opaca, foto tomada con flash de una cámara desechable.",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "modelVersion": "dev",
  "outputFormat": "jpg",
  "guidanceScale": 3.5,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 28
}

Output

The output of this action is typically a JSON array containing the URLs of the generated images.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/e861a38b-f7f0-4c3c-b67c-9dd0c7f6e4aa/1fa4294e-248e-4610-b2ea-24ebafb98874.jpg"
]

Conceptual Usage Example (Python)

Here’s how a developer might call the Generate Image action using Python:

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 = "1e594329-9816-4237-af78-296bb6e8614d"  # Action ID for Generate Image with Inpainting and Customization

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/LqEfJlfZRn3Q75zJhC6rpoUlubLtbBXrAe1PpStwYkiRFvaD/replicate-prediction-ads3p6xg45rj20cjprs9abwstc.png",
    "prompt": "lunavestl vestida como Blanca Nieves, tiene piel sin brillo y opaca, foto tomada con flash de una cámara desechable.",
    "loraScale": 1,
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "modelVersion": "dev",
    "outputFormat": "jpg",
    "guidanceScale": 3.5,
    "outputQuality": 90,
    "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}")

In this code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID is set for the image generation task, and the input is structured according to the action’s requirements.

Conclusion

The arietudo/lunavestl Cognitive Actions provide a powerful and flexible way to integrate image generation capabilities into your applications. By using the Generate Image with Inpainting and Customization action, developers can harness the power of AI to create unique and customized images based on specific prompts and parameters. As you explore these capabilities, consider experimenting with different settings and configurations to enhance the creative possibilities within your projects.

← Back to All Articles