image-generation

Create Stunning Stylized Portraits Effortlessly with Omni Zero

25 Apr 2025
Create Stunning Stylized Portraits Effortlessly with Omni Zero

In the world of image generation, the Omni Zero service stands out by offering powerful Cognitive Actions tailored for developers looking to create visually striking content. One of its key features, the "Create Stylized Portrait" action, leverages a sophisticated diffusion pipeline to generate stylized portraits with zero-shot capabilities. This functionality allows for remarkable flexibility in combining diverse identities and artistic styles, making it an invaluable tool for applications ranging from digital art creation to personalized avatar generation.

Imagine a scenario where an artist wants to create unique portraits for their clients but lacks the time or technical skills to manually craft each image. With the Omni Zero action, they can simply provide a base identity image and a style reference, and the system will generate a stunning portrait in a matter of moments. This not only speeds up the creative process but also simplifies it, allowing artists to focus on their vision rather than the technicalities of image manipulation.

Prerequisites

Before diving into the integration of the Omni Zero action, ensure you have a valid Cognitive Actions API key and a basic understanding of API calls. This will enable you to authenticate and interact with the service seamlessly.

Create Stylized Portrait

The "Create Stylized Portrait" action is designed to generate a stylized portrait by utilizing the Omni-Zero diffusion pipeline, which excels in producing images that reflect specific identity and style combinations without requiring extensive training data.

Input Requirements

The action requires a few essential inputs:

  • identityImage: A URI pointing to the base identity image.
  • styleImage: A URI for the style image that dictates the artistic direction.
  • Additional parameters like prompt, guidanceScale, and numberOfSteps can be adjusted to refine the output.

For example, a typical input might look like this:

{
  "seed": 42,
  "prompt": "A person",
  "styleImage": "https://example.com/style-image.jpg",
  "guidanceScale": 3,
  "identityImage": "https://example.com/identity-image.jpg",
  "numberOfSteps": 10,
  "negativePrompt": "blurry, out of focus",
  "numberOfImages": 1,
  "compositionImage": "https://example.com/composition-image.jpg"
}

Expected Output

The expected output is a URI that links to the generated portrait image. For instance, a successful call might return:

[
  "https://assets.cognitiveactions.com/invocations/a739eef8-0b11-434a-b8f5-b991ec4109b0/960554ba-5508-4c09-8099-2b6653ceb7d0.jpg"
]

Use Cases for this Specific Action

This action is particularly useful in various scenarios:

  • Digital Art: Artists can quickly prototype and visualize different styles for their characters or concepts.
  • Gaming: Game developers can create unique character avatars without extensive graphic design resources.
  • Social Media: Influencers or brands can generate personalized content that resonates with their audience’s aesthetic preferences.

By providing a simple way to generate high-quality stylized portraits, the Omni Zero action empowers developers to enhance user engagement and creativity in their applications.

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 = "6c31152f-d8cc-4485-b794-65773d71ffbe" # Action ID for: Create Stylized Portrait

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "seed": 42,
  "prompt": "A person",
  "styleImage": "https://github.com/okaris/omni-zero/assets/1448702/64dc150b-f683-41b1-be23-b6a52c771584",
  "guidanceScale": 3,
  "identityImage": "https://github.com/okaris/omni-zero/assets/1448702/ba193a3a-f90e-4461-848a-560454531c58",
  "numberOfSteps": 10,
  "negativePrompt": "blurry, out of focus",
  "numberOfImages": 1,
  "compositionImage": "https://github.com/okaris/omni-zero/assets/1448702/2ca63443-c7f3-4ba6-95c1-2a341414865f"
}

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 "Create Stylized Portrait" action from Omni Zero offers developers a powerful tool to generate unique and visually appealing portraits with ease. By integrating this action, you can significantly reduce the time and effort required for image creation, allowing for a more efficient workflow and enhanced creative possibilities. As you explore this functionality, consider the numerous applications it can have in your projects, from digital art to personalized content creation. Embrace the power of AI-driven image generation and elevate your creative endeavors with Omni Zero.

← Back to All Articles