image-generation

Effortless Identity-Preserving Image Generation with AlbedoBase XL

25 Apr 2025
Effortless Identity-Preserving Image Generation with AlbedoBase XL

In the world of digital content creation, the need for high-quality images that preserve specific identities is more crucial than ever. The Instant Id Albedobase XL offers developers a powerful solution to generate identity-preserving images quickly and efficiently. Leveraging the advanced LCM-LoRA model, this service allows for the rapid creation of images while maintaining the integrity of the subject's identity. With customizable parameters for image dimensions, prompts, and safety checks, developers can streamline their workflow and enhance the creative process.

Common use cases for the Instant Id Albedobase XL include generating images for character design in video games, producing unique artwork for marketing campaigns, or creating personalized content for social media. By utilizing this service, developers can save time and resources while ensuring that each image meets their specific requirements.

Prerequisites

To get started, you'll need an API key for the Cognitive Actions service and a basic understanding of how to make API calls.

Perform Identity-Preserving Image Generation

The Perform Identity-Preserving Image Generation action enables you to generate zero-shot identity-preserving images in seconds. This action utilizes the LCM-LoRA model with AlbedoBase-XL v2.0 as its foundation, ensuring that the images produced are not only high-quality but also tailored to the unique characteristics of the subject.

Input Requirements

The input for this action requires a CompositeRequest object, which must include:

  • image (string, required): A URI of the input image.
  • width (integer, optional): The width of the output image in pixels (default is 640, must be between 512 and 2048).
  • height (integer, optional): The height of the output image in pixels (default is 640, must be between 512 and 2048).
  • prompt (string, optional): A textual description guiding the image generation (default is a detailed analog film photo description).
  • guidanceScale (number, optional): A scale for classifier-free guidance (default is 0, optimal values usually range from 0 to 5).
  • safetyChecker (boolean, optional): A toggle to enable or disable the safety checker (enabled by default).
  • ipAdapterScale (number, optional): Scaling factor for the IP adapter (default is 0.8, must be between 0 and 1).
  • negativePrompt (string, optional): Text input to guide against certain elements during image generation.
  • numInferenceSteps (integer, optional): The total number of denoising steps to perform (default is 6, optimal range is 6-8).
  • controlnetConditioningScale (number, optional): ControlNet conditioning scale factor (default is 0.8, must be between 0 and 1).

Expected Output

The expected output is a URI of the generated image, which will reflect the input image's identity while adhering to the specified parameters.

Use Cases for this Specific Action

This action is particularly useful in scenarios where maintaining an individual’s likeness is critical, such as:

  • Character Design: Quickly create images of characters for games or animations while preserving their unique traits.
  • Marketing Content: Generate personalized images for targeted advertising campaigns that resonate with specific audiences.
  • Artistic Projects: Produce artwork that requires a blend of personal identity and creative expression, allowing artists to explore new styles while retaining recognizable features.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "a5f58da6-afef-45a9-b272-0684d08c59df" # Action ID for: Perform Identity-Preserving Image Generation

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "image": "https://replicate.delivery/pbxt/KIuaBkQJUNjzsAce8hZDbWmKAdOYIhoeCcyA4EBoguEnhjDU/bp_lisa.png",
  "width": 640,
  "height": 640,
  "prompt": "A digital elven princess with vibrant anime art style shines in a palette of dark pink and teal, In the style  of artists Shilin Huang and Guillaume Seignac. Exudes an aura of heavenly angel, perfectly blending the elements of sultriness and ethereal beauty. The eyes, brimming with life, sparkle with a mesmerizing shine, adding a touch of spectral fascination to her already captivating presence",
  "guidanceScale": 0,
  "safetyChecker": true,
  "ipAdapterScale": 0.2,
  "numInferenceSteps": 6,
  "controlnetConditioningScale": 0.8
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

The Instant Id Albedobase XL transforms the way developers approach image generation by providing a fast, efficient, and customizable solution for creating identity-preserving images. With versatile use cases ranging from gaming to marketing, this service can significantly enhance your creative projects. As you explore the possibilities, consider how the integration of these cognitive actions can streamline your workflow and elevate your content creation efforts.

← Back to All Articles