image-generation

Create Stunning Images with the Ithiago Character

26 Apr 2025
Create Stunning Images with the Ithiago Character

Ithiago is an innovative service designed for developers looking to harness the power of AI-driven image generation. With its unique capability to create images featuring the beloved Thiago character from the short film Boitatá, Ithiago simplifies the creative process, allowing you to generate high-quality images quickly and efficiently. Whether you're creating content for marketing, entertainment, or personal projects, Ithiago provides a versatile toolset that can meet your specific needs.

Developers can leverage Ithiago's image generation capabilities in various scenarios, such as producing custom illustrations for storytelling, enhancing digital artwork, or generating unique visuals for social media campaigns. The integration of features like image inpainting, customizable aspect ratios, and multiple output formats enables a wide range of creative possibilities.

Before diving into the details of the actions, make sure you have a Cognitive Actions API key and a basic understanding of making API calls.

Generate Image with Thiago Character

The "Generate Image with Thiago Character" action allows you to create images that feature the Thiago character, making it an ideal solution for projects that require unique and engaging visuals. This action supports various customization options, including image inpainting, aspect ratios, and output formats, enabling developers to tailor the generated images to their specific requirements.

Input Requirements

To successfully use this action, you need to provide the following inputs:

  • prompt: A descriptive string that guides the image generation process. For example, "ITHIAGO the bald man, is looking to the camera, scratching her head."
  • model: Choose between "dev" for high-quality generation or "schnell" for faster output.
  • outputCount: Specify the number of images to generate, ranging from 1 to 4.
  • guidanceScale: A numerical value that influences the fidelity of the generated image.
  • outputQuality: A value from 0 to 100 that defines the image quality (not applicable for PNG format).
  • imageAspectRatio: Set the desired aspect ratio for the image, such as "1:1" or "16:9".
  • imageOutputFormat: Choose the format for the output image (webp, jpg, png).
  • Additional parameters like seed, mask, and promptStrength can further refine the image generation process.

Expected Output

The output of this action will be a URL linking to the generated image, allowing you to easily access and utilize the visual content in your projects.

Use Cases for this Specific Action

This action is particularly useful in scenarios such as:

  • Creating unique character illustrations for digital storytelling or games.
  • Generating visuals for marketing materials that require distinctive imagery.
  • Enhancing user engagement on social media by sharing custom images.
  • Utilizing image inpainting to modify existing visuals with the Thiago character.
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 = "b205d5cd-0fb5-4756-85cd-e083ed72d7c5" # Action ID for: Generate Image with Thiago Character

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "prompt": "ITHIAGO the bald man, is looking to the camera, scratching her head.",
  "outputCount": 1,
  "guidanceScale": 2.03,
  "outputQuality": 100,
  "promptStrength": 0.85,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "png",
  "mainLoraIntensity": 1,
  "denoisingStepsCount": 28,
  "additionalLoraIntensity": 1
}

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

Ithiago provides developers with a powerful tool for generating engaging imagery featuring the Thiago character. With its array of customizable options and quick generation capabilities, Ithiago is an excellent choice for anyone looking to enhance their creative projects.

As a next step, consider exploring additional features of the Ithiago service to further enrich your applications, or integrate it into existing workflows to streamline your image creation process. Embrace the potential of AI-driven visuals and elevate your creative projects today!

← Back to All Articles