Generate Stunning Visuals with the garyvoo/person2_new Cognitive Action

21 Apr 2025
Generate Stunning Visuals with the garyvoo/person2_new Cognitive Action

In today's digital landscape, the ability to create high-quality images programmatically has become increasingly important for developers. The garyvoo/person2_new API provides a powerful Cognitive Action designed for this purpose: Generate Enhanced Image. This action harnesses advanced image generation techniques, including image inpainting and LoRA models, enabling developers to create customized images tailored to their specific needs. By leveraging these pre-built actions, developers can significantly reduce the time and effort required to implement sophisticated image generation capabilities in their applications.

Prerequisites

Before diving into using the Generate Enhanced Image action, ensure you have the following prerequisites in place:

  • An API key for the Cognitive Actions platform.
  • Basic understanding of JSON format for constructing requests.
  • Familiarity with sending HTTP requests using a programming language like Python.

Authentication typically involves passing your API key in the request headers, allowing you to securely access the Cognitive Actions API.

Cognitive Actions Overview

Generate Enhanced Image

The Generate Enhanced Image action creates high-quality images based on a text prompt, with options for customizing dimensions, format, and quality. This action is part of the image-generation category and offers developers a rich set of features to manipulate image outputs.

Input

The input to this action is a JSON object that can include various optional fields to customize image generation. Here’s a breakdown of the required and optional fields:

  • prompt (required): Text prompt to guide image generation (e.g., "a photo of yeseul, as queen").
  • model (optional): Choose between "dev" (default) and "schnell" models.
  • aspectRatio (optional): Control the proportion of the generated image (default: "1:1").
  • outputFormat (optional): Specify the file format for the output image (default: "webp").
  • loraIntensity (optional): Adjusts the intensity of the primary LoRA (default: 1).
  • outputQuality (optional): Sets the quality of saved images (default: 80).
  • numberOfOutputs (optional): How many images to generate (default: 1, max: 4).
  • additionalLoraIntensity (optional): Intensity for additional LoRA (default: 1).

Here’s an example of the JSON payload needed to invoke the action:

{
  "model": "dev",
  "prompt": "a photo of yeseul, as queen",
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "loraIntensity": 1,
  "outputQuality": 74,
  "numberOfOutputs": 4,
  "additionalLoraIntensity": 1
}

Output

Upon successful execution, the action returns an array of URLs pointing to the generated images. Here's an example of what the output might look like:

[
  "https://assets.cognitiveactions.com/invocations/8c63b929-44ff-40dd-8953-e1ba5c2b7195/a1497bb4-9bb0-48f8-a803-0622dce4fdcb.webp",
  "https://assets.cognitiveactions.com/invocations/8c63b929-44ff-40dd-8953-e1ba5c2b7195/f3a5f208-0cb5-45ca-b6ae-69f066168960.webp",
  "https://assets.cognitiveactions.com/invocations/8c63b929-44ff-40dd-8953-e1ba5c2b7195/9e553530-4800-415f-a0cc-e7bee45fc6e6.webp",
  "https://assets.cognitiveactions.com/invocations/8c63b929-44ff-40dd-8953-e1ba5c2b7195/c384504c-1d3d-4678-8023-43e00a295371.webp"
]

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the Generate Enhanced Image action.

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 = "f9fd671f-6138-4f19-be07-1744f9417be4"  # Action ID for Generate Enhanced Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "a photo of yeseul, as queen",
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "loraIntensity": 1,
    "outputQuality": 74,
    "numberOfOutputs": 4,
    "additionalLoraIntensity": 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 code, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action ID for the Generate Enhanced Image is included, along with the structured input payload. The endpoint URL, along with the request structure, is illustrative and should be adapted based on the actual API documentation.

Conclusion

The Generate Enhanced Image action from the garyvoo/person2_new API offers developers a robust tool for creating high-quality images tailored to their specifications. With its flexible input options and detailed output, integrating this action can significantly enhance the visual capabilities of your applications. Consider experimenting with different prompts and settings to unlock the full potential of this image generation action in your next project!

← Back to All Articles