image-generation

Enhance Your Images with Photorealistic Fx Controlnet

26 Apr 2025
Enhance Your Images with Photorealistic Fx Controlnet

In the realm of digital image processing, achieving photorealistic results can often be a complex and time-consuming endeavor. Enter the Photorealistic Fx Controlnet, a powerful Cognitive Action designed to streamline the process of generating stunningly realistic images. By leveraging the capabilities of RunDiffusion's PhotorealisticFX model, this tool allows developers to create high-quality images with customizable parameters that enhance both the output quality and focus.

Whether you're working on game development, visual effects, or graphic design, the ability to generate photorealistic images quickly and efficiently can significantly elevate your projects. Imagine being able to take a simple sketch or a low-resolution image and transform it into a lifelike depiction, ready for use in marketing materials, presentations, or even as part of a larger artistic endeavor.

Prerequisites

To get started with Photorealistic Fx Controlnet, you'll need an API key for the Cognitive Actions service and a basic understanding of making API calls.

Enhance Image Photorealism with ControlNet

The "Enhance Image Photorealism with ControlNet" action serves as the cornerstone of this service. Its purpose is to generate photorealistic images from an input image, allowing developers to specify various parameters to fine-tune the results.

Input Requirements

The action requires a structured input consisting of:

  • image (string): The URI of the input image you want to enhance.
  • scale (number): The guidance scale for classifier-free guidance, defaulting to 9.
  • steps (integer): The number of denoising steps to perform, with a default of 20.
  • prompt (string): A guiding text for the generation process, which can be customized.
  • structure (string): The foundational structural element like "canny" or "depth".
  • lowThreshold and highThreshold (integer): Values that affect edge detection sensitivity.
  • negativePrompt (string): Text to avoid certain characteristics in the output.
  • imageResolution (string): The pixel dimensions for the output image.
  • numberOfSamples (string): How many sample images to generate.
  • additionalPrompt (string): Extra descriptive text to enhance the main prompt.

Expected Output

The action returns one or more URIs of the generated images, which can be directly accessed and utilized in your projects.

Use Cases for this specific action

This action is particularly useful in scenarios such as:

  • Game Development: Creating realistic textures and backgrounds that enhance the immersive experience of games.
  • Marketing and Advertising: Generating eye-catching visuals for campaigns that demand high-quality images.
  • Artistic Projects: Assisting artists in visualizing concepts or enhancing existing artwork with photorealistic elements.
  • Product Design: Producing realistic renderings for prototypes or promotional materials.

By utilizing this action, developers can significantly reduce the time and effort spent on image enhancement while achieving professional-grade results.

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 = "fa87b45c-b2c4-42e1-8aab-701e1c471a7d" # Action ID for: Enhance Image Photorealism with ControlNet

# 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/IzhXiQKcw0bDVYSr36ud9eCHakjdzCeXPylw2CVube3y7Tlh/user_1.png",
  "scale": 9,
  "steps": 20,
  "prompt": "a photo of a brightly colored turtle",
  "structure": "scribble",
  "lowThreshold": 100,
  "highThreshold": 200,
  "negativePrompt": "(semi-realistic, cgi, 3d, render, sketch, cartoon, drawing, anime:1.4), text, close up, cropped, out of frame, worst quality, low quality, jpeg artifacts, ugly, duplicate, morbid, mutilated, extra fingers, mutated hands, poorly drawn hands, poorly drawn face, mutation, deformed, blurry, dehydrated, bad anatomy, bad proportions, extra limbs, cloned face, disfigured, gross proportions, malformed limbs, missing arms, missing legs, extra arms, extra legs, fused fingers, too many fingers, long neck",
  "imageResolution": "512",
  "numberOfSamples": "1",
  "additionalPrompt": "Best quality, extremely detailed"
}

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 Photorealistic Fx Controlnet provides developers with an invaluable tool for generating high-quality images with ease. Its flexible parameter options and ability to produce stunning visuals open up a world of possibilities across various industries and applications. Whether you're enhancing game graphics, creating marketing materials, or exploring artistic endeavors, this Cognitive Action can help you achieve your vision faster and more efficiently. To get started, integrate this action into your workflow and unlock the potential of photorealistic image generation.

← Back to All Articles