Generate Stunning Face Images Using lucataco/ip-adapter-faceid Actions

24 Apr 2025
Generate Stunning Face Images Using lucataco/ip-adapter-faceid Actions

Integrating the capabilities of the lucataco/ip-adapter-faceid API can empower developers to create a variety of styled images from facial data. The primary Cognitive Action offered here, Generate Styled Face Images, allows for the transformation of a face image into different styles based on textual prompts. This functionality is particularly beneficial for research purposes, enabling users to maintain face ID consistency while exploring creative visual outputs.

Prerequisites

Before you can start using the Cognitive Actions, ensure you have:

  • An API key for the Cognitive Actions platform.
  • Familiarity with sending HTTP requests and handling JSON data.
  • Basic understanding of Python for the conceptual usage examples.

Authentication typically involves passing your API key in the headers of your requests, allowing secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Styled Face Images

Description: This action generates various styled images based on a provided face using text prompts. It leverages face ID embeddings for style transformation, ensuring ID consistency—ideal for research purposes.

Category: Image Generation

Input

This action requires the following fields in its input schema:

  • faceImage (string, required): A URI pointing to the input face image.
  • width (integer, optional): The width of the output image in pixels (default: 1024).
  • height (integer, optional): The height of the output image in pixels (default: 1024).
  • prompt (string, optional): Textual prompt to guide image generation (default: "photo of a woman in red dress in a garden").
  • negativePrompt (string, optional): A description of undesired elements in the output (default: "monochrome, lowres, bad anatomy, worst quality, low quality, blurry").
  • numberOfOutputs (integer, optional): The number of images to generate (must be between 1 and 4, default: 1).
  • agreeToResearchOnly (boolean, optional): Confirmation to use the model strictly for research purposes (default: false).
  • numberOfInferenceSteps (integer, optional): Number of denoising steps in image generation (1-200, default: 30).
  • seed (integer, optional): A random seed for image generation (leave blank for a random seed).

Example Input:

{
  "seed": 2212213399,
  "width": 1024,
  "height": 1024,
  "prompt": "photo of a woman in red dress in a garden",
  "faceImage": "https://replicate.delivery/pbxt/K5DSwf3aUzIpS4srbRhNQkESybPovfXwEfjIuDMj3Dz86tDV/demo.png",
  "negativePrompt": "monochrome, lowres, bad anatomy, worst quality, low quality, blurry, multiple people",
  "numberOfOutputs": 1,
  "agreeToResearchOnly": true,
  "numberOfInferenceSteps": 30
}

Output

The action typically returns an array of URIs pointing to the generated images. For example:

[
  "https://assets.cognitiveactions.com/invocations/f3c0fcb3-f397-427d-88f5-2f07beed8a2a/b09d1523-888a-4e95-8e2e-e6a32fe7bc2f.png"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet demonstrating how to call the Generate Styled Face Images 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 = "f84ef1fd-df4f-41c2-8acf-23c78070ed35" # Action ID for Generate Styled Face Images

# Construct the input payload based on the action's requirements
payload = {
    "seed": 2212213399,
    "width": 1024,
    "height": 1024,
    "prompt": "photo of a woman in red dress in a garden",
    "faceImage": "https://replicate.delivery/pbxt/K5DSwf3aUzIpS4srbRhNQkESybPovfXwEfjIuDMj3Dz86tDV/demo.png",
    "negativePrompt": "monochrome, lowres, bad anatomy, worst quality, low quality, blurry, multiple people",
    "numberOfOutputs": 1,
    "agreeToResearchOnly": true,
    "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, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload is constructed based on the specified requirements of the action, and the response is printed in a formatted manner. The endpoint URL and request structure provided here are illustrative and may vary based on your actual setup.

Conclusion

The Generate Styled Face Images action from the lucataco/ip-adapter-faceid API provides a powerful tool for developers looking to create visually appealing content based on facial data. By using text prompts, you can guide the generation process to yield unique and styled images suitable for research and creative applications. Consider exploring further use cases or integrating multiple actions to enhance your application's capabilities. Happy coding!

← Back to All Articles