Generate Stunning Images with the vincentbui/genpack Cognitive Actions

22 Apr 2025
Generate Stunning Images with the vincentbui/genpack Cognitive Actions

In today's digital landscape, the ability to generate high-quality images programmatically has become increasingly valuable for developers. The vincentbui/genpack API offers a powerful Cognitive Action that enables developers to create predictive images tailored to specific prompts. This article will guide you through the Generate Predictive Image action, detailing its capabilities and providing examples to help you integrate it into your applications seamlessly.

Prerequisites

Before you begin using the Cognitive Actions, ensure you have:

  • An API key for the Cognitive Actions platform.
  • Familiarity with making HTTP requests in your preferred programming language.

Authentication typically involves including your API key in the headers of your requests. This ensures secure access to the API.

Cognitive Actions Overview

Generate Predictive Image

The Generate Predictive Image action allows you to create images based on detailed textual prompts using two optimized models: dev and schnell. This action supports features like image inpainting, customizable prompt strength, and adjustable output quality, making it versatile for various use cases in image generation.

Input

The input for this action is structured as a JSON object. Below are the required and optional fields based on the schema:

  • Required Field:
    • prompt: A string guiding the generation of the image.
  • Optional Fields:
    • mask: URI for image inpainting.
    • seed: An integer for reproducibility.
    • image: URI for input images.
    • width: Width of the generated image (limited to certain conditions).
    • height: Height of the generated image (limited to certain conditions).
    • goFast: Boolean to enable faster generation.
    • numOutputs: Number of images to generate.
    • guidanceScale: Influences the diffusion process.
    • outputQuality: Quality level of the output image.
    • imageAspectRatio: Aspect ratio for the image.
    • imageOutputFormat: Format of the output image (e.g., webp, jpg).
    • Additional parameters for LoRA weights and scaling.

Example Input:

{
  "goFast": false,
  "prompt": "packaging pf PGKTH The image features a dietary supplement product named \"Pilonix\" The packaging includes a blue and white box alongside a dark brown bottle with a black cap...",
  "loraScale": 1,
  "numOutputs": 1,
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28,
  "approximateMegapixels": "1"
}

Output

The action typically returns an array of image URLs generated based on the provided prompt. This allows you to retrieve and utilize the images directly in your application.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/8cee937d-5078-4cad-945f-b7dff8d5ba4a/f49016f6-c0fb-4e00-8659-a581fadd830e.webp"
]

Conceptual Usage Example (Python)

Here's a conceptual example demonstrating how to invoke the Generate Predictive Image action using Python. This example focuses on structuring the input JSON payload correctly.

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 = "eb4aa472-ae4a-4994-89ad-c8b562faa498"  # Action ID for Generate Predictive Image

# Construct the input payload based on the action's requirements
payload = {
    "goFast": false,
    "prompt": "packaging pf PGKTH The image features a dietary supplement product named \"Pilonix\" The packaging includes a blue and white box alongside a dark brown bottle with a black cap...",
    "loraScale": 1,
    "numOutputs": 1,
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "numInferenceSteps": 28,
    "approximateMegapixels": "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 snippet, replace the placeholders with your actual API key and ensure the structure of the payload matches the specified input requirements. The endpoint URL and request format are illustrative; adjust them as necessary for your actual integration.

Conclusion

The Generate Predictive Image action from the vincentbui/genpack API provides developers with a rich toolkit for image generation based on textual prompts. By leveraging this Cognitive Action, you can create tailored images for various applications, enhancing user engagement and creativity. Explore further by experimenting with different prompts and parameters to unlock the full potential of this powerful tool!

← Back to All Articles