Create Stunning 3D Avatars with roblo3x/lora-3d-avatars Cognitive Actions

23 Apr 2025
Create Stunning 3D Avatars with roblo3x/lora-3d-avatars Cognitive Actions

In the world of digital content creation, generating lifelike 3D avatars is no longer a daunting task. The roblo3x/lora-3d-avatars API provides developers with powerful Cognitive Actions that convert text prompts into customizable 3D avatar images. These actions leverage advanced image generation models, enabling users to create stunning visuals tailored to their specifications. With options for inpainting and accelerated predictions, integrating these actions into your applications can significantly enhance user engagement and creativity.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of JSON and how to make API calls.
  • Familiarity with Python for the conceptual usage examples provided.

Authentication is typically done by passing the API key in the request headers, allowing secure access to the various actions.

Cognitive Actions Overview

Generate 3D Avatar Images

Description: This action converts text prompts into 3D avatar images with customizable styles, sizes, and quality. It supports inpainting and offers options for faster results through optimized predictions.

Category: Image Generation

Input

The input schema for this action requires the following fields:

  • prompt (required): A text description guiding the image generation. For example: 
    "prompt": "3D female character design, simple minimal cute cartoon style, headshot, tanned skin, small ears and nose, pink cheeks, pastel colors"

The action supports several optional fields to customize the output further:

  • mask: URI of the image mask for inpainting.
  • seed: Random seed for deterministic image generation.
  • image: URI of the input image for image-to-image conversion.
  • width and height: Desired dimensions for the generated image.
  • fastMode: Enables speed-optimized predictions.
  • outputCount: Number of images to generate at once (1 to 4).
  • guidanceScale: Adjusts the influence of the guidance process.
  • outputQuality: Compression level for output images.
  • extraLoraScale: Intensity of extra LoRA application.
  • inferenceModel: Selects the model for inference.
  • promptStrength: Regulates the prompt's influence in image-to-image mode.
  • imageAspectRatio: Determines the aspect ratio for generation.
  • outputImageFormat: Specifies the file format for generated images.
  • inferenceStepsCount: Number of denoising steps in the generation process.
  • loraApplicationScale: Strength of the main LoRA application.
  • additionalLoraWeights: Additional weights for LoRA application.
  • approximateMegapixels: Estimated megapixel count.
  • safetyCheckerDisabled: Option to disable the safety checker.
Example Input
{
  "image": "https://replicate.delivery/pbxt/M9hl4KXsfFRPTjwRgpAoYG9Eqk5XPkLzxKmjZ88nHh7MzSVA/avatar.png",
  "prompt": "3D female character design, simple minimal cute cartoon style, headshot, tanned skin, small ears and nose, pink cheeks, pastel colors",
  "fastMode": false,
  "outputCount": 4,
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 1,
  "imageAspectRatio": "1:1",
  "outputImageFormat": "webp",
  "inferenceStepsCount": 45,
  "loraApplicationScale": 1,
  "approximateMegapixels": "1"
}

Output

The action typically returns an array of URLs to the generated images. An example output might look like:

[
  "https://assets.cognitiveactions.com/invocations/f92b2d19-5983-4a96-9a7d-8368755e3542/d51c653a-be48-4ce0-8e15-9ce7ff57a03a.webp",
  "https://assets.cognitiveactions.com/invocations/f92b2d19-5983-4a96-9a7d-8368755e3542/900a2acc-14bc-44cf-981a-8a5e606109d0.webp",
  "https://assets.cognitiveactions.com/invocations/f92b2d19-5983-4a96-9a7d-8368755e3542/1c8ffc65-23a8-4041-895e-a29df09a27a9.webp",
  "https://assets.cognitiveactions.com/invocations/f92b2d19-5983-4a96-9a7d-8368755e3542/458e4c66-7ca7-4a11-9a36-1d2838a38fb1.webp"
]

Conceptual Usage Example (Python)

Here’s how you might call this 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 = "e66141ff-31f3-4e48-876c-62ff4c2e531d"  # Action ID for Generate 3D Avatar Images

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/M9hl4KXsfFRPTjwRgpAoYG9Eqk5XPkLzxKmjZ88nHh7MzSVA/avatar.png",
    "prompt": "3D female character design, simple minimal cute cartoon style, headshot, tanned skin, small ears and nose, pink cheeks, pastel colors",
    "fastMode": False,
    "outputCount": 4,
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 1,
    "imageAspectRatio": "1:1",
    "outputImageFormat": "webp",
    "inferenceStepsCount": 45,
    "loraApplicationScale": 1,
    "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 Python code snippet, replace the COGNITIVE_ACTIONS_API_KEY and the endpoint URL with the actual values. The action_id is set for generating 3D avatar images, and the input payload is structured according to the action's requirements.

Conclusion

The roblo3x/lora-3d-avatars Cognitive Action for generating 3D avatar images offers developers a powerful tool for creating engaging digital content. By integrating these actions, you can streamline the process of avatar creation, allowing for customizable options that enhance user experience. Whether you're building games, virtual worlds, or other interactive experiences, these actions can significantly broaden your creative horizons. Explore the possibilities today and start creating stunning 3D avatars!

← Back to All Articles