Generate Stunning Variations with lucataco/ip_adapter-sdxl-face Cognitive Actions

22 Apr 2025
Generate Stunning Variations with lucataco/ip_adapter-sdxl-face Cognitive Actions

In the world of AI-driven content creation, the lucataco/ip_adapter-sdxl-face API offers a powerful way to generate stunning images based on existing visual prompts. This API leverages a pretrained text-to-image diffusion model to create variations from an input face image guided by textual prompts. With the ease of integration provided by the Cognitive Actions, developers can quickly enhance their applications with advanced image generation capabilities.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of handling HTTP requests and working with JSON data.
  • Familiarity with Python for implementing the provided code snippets.

To authenticate your requests, you will typically pass your API key in the headers of your HTTP requests.

Cognitive Actions Overview

Generate SDXL Images with Image Prompt

The Generate SDXL Images with Image Prompt action allows you to utilize an image prompt adapter to produce SDXL images based on a given face image and a descriptive text prompt. This action is particularly useful for creating variations of images that maintain the essence of the original while following the guidance of the provided prompt.

Input

The input for this action requires the following fields:

  • image (required): The URI of the input face image. This image acts as the foundation for generating variations.
  • seed (optional): An integer for initializing the random number generator. Leave blank for randomization.
  • scale (optional): A floating-point number (0 to 1) representing the influence of the input image on the generation. Defaults to 0.6.
  • prompt (optional): A text prompt guiding the image generation. If left blank, the focus will be on generating variations.
  • negativePrompt (optional): A text prompt specifying elements to avoid in the generation.
  • numberOfOutputs (optional): An integer indicating how many output images to generate (1 to 4). Defaults to 1.
  • numberOfInferenceSteps (optional): An integer representing the number of denoising steps (1 to 500) during image generation. Defaults to 30.

Example Input:

{
  "seed": 42,
  "image": "https://replicate.delivery/pbxt/JqifieOm5VA07pzpBWY4BNr2cf9YpQRjbGT3wBYFx9ANENSf/ai_face2.png",
  "scale": 0.6,
  "prompt": "photo of a beautiful girl wearing casual shirt in a garden",
  "negativePrompt": "",
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 30
}

Output

The output of this action typically returns an array of generated image URIs. Depending on your settings, you may receive one or more links to the newly created images.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/7911de90-ee9d-4fb4-960b-f5f1d52d6a29/94226713-5ab5-4a0a-8d0f-b580c39b269a.png"
]

Conceptual Usage Example (Python)

Here’s a conceptual example of how you might call the Generate SDXL Images with Image Prompt 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 = "7634fc77-f0c7-4b09-9f0a-08b7e3978f49"  # Action ID for Generate SDXL Images with Image Prompt

# Construct the input payload based on the action's requirements
payload = {
    "seed": 42,
    "image": "https://replicate.delivery/pbxt/JqifieOm5VA07pzpBWY4BNr2cf9YpQRjbGT3wBYFx9ANENSf/ai_face2.png",
    "scale": 0.6,
    "prompt": "photo of a beautiful girl wearing casual shirt in a garden",
    "negativePrompt": "",
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 30
}

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, you need to replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID is specified for the Generate SDXL Images with Image Prompt, and the input payload is constructed based on the required fields. The example demonstrates how to handle the response and potential errors.

Conclusion

The lucataco/ip_adapter-sdxl-face Cognitive Actions provide a robust framework for generating creative and personalized images with ease. By leveraging the capabilities of image prompts and textual guidance, you can enhance your applications and create visually stunning content. Explore the potential of these actions and consider integrating them into your projects for a seamless experience in image generation!

← Back to All Articles