Elevate Your Applications with High-Quality Image Generation Using Instant ID Cognitive Actions

21 Apr 2025
Elevate Your Applications with High-Quality Image Generation Using Instant ID Cognitive Actions

In today's digital landscape, the ability to generate high-quality images can significantly enhance user experience and engagement within applications. The Instant ID Cognitive Actions provide developers with powerful tools to automate high-quality image generation, complete with face detection and enhancement capabilities. This blog post will guide you through the available Cognitive Action and how to seamlessly integrate it into your applications.

Prerequisites

Before diving into the integration process, you'll need to ensure you have the following:

  • API Key: Obtain an API key from the Cognitive Actions platform to authenticate your requests.
  • Setup: Familiarize yourself with basic JSON structures and HTTP request handling.

Authentication typically involves passing your API key in the request headers, allowing secure access to the Cognitive Actions functionalities.

Cognitive Actions Overview

Perform High-Quality Image Generation

The Perform High-Quality Image Generation action generates images with advanced features such as face detection, enhancement, and customizable parameters like resolution and pose alignment.

Input

The input for this action requires a structured JSON object with the following fields:

{
  "image": "https://replicate.delivery/pbxt/KKGcCIfS4huVfI9XhgutsO4x0dZhnEDF8YNGUNOT1yxutgvk/53894527.jpg",
  "width": 917,
  "height": 920,
  "prompt": "This is Eric Draven The Crow Movie 1994 version, Brandon Lee, realistic, 8k, the crow bird, portrait",
  "scheduler": "UniPCMultistep",
  "maximumResolution": 1280,
  "minimumResolution": 1024,
  "shouldResizeImage": true,
  "enhanceFacialRegion": true,
  "inferenceStepsCount": 10,
  "classifierGuidanceScale": 3.5,
  "ipAdapterIntensityScale": 1,
  "negativePromptDescription": "(worst quality, low quality, normal quality, lowres, low details, oversaturated, undersaturated, overexposed, underexposed)+",
  "microDetailAdjustmentWeight": 0.5,
  "controlNetConditioningIntensity": 0.49
}

Key Fields Explained:

  • image: URI of the input image to be processed.
  • width: Width of the image (default: 640, max: 2048).
  • height: Height of the image (default: 640, max: 2048).
  • prompt: Descriptive text to guide image generation.
  • scheduler: The scheduling strategy for processing.
  • maximumResolution: Maximum allowable resolution for resized images.
  • minimumResolution: Minimum allowable resolution for resized images.
  • shouldResizeImage: Flag to indicate if resizing should occur (default: true).
  • enhanceFacialRegion: Indicates if facial regions should be enhanced (default: true).
  • inferenceStepsCount: Number of denoising steps for synthesis (default: 30).
  • classifierGuidanceScale: Strength of guidance (default: 5).
  • ipAdapterIntensityScale: Scaling factor for intensity (default: 0.8).
  • negativePromptDescription: Text to deprioritize undesired features.
  • microDetailAdjustmentWeight: Weight for micro detail adjustments (default: 0).
  • controlNetConditioningIntensity: Conditioning intensity for ControlNet (default: 0.8).

Output

The output of this action is typically a URI pointing to the generated image. For example:

https://assets.cognitiveactions.com/invocations/205be54a-59b4-46fc-b67a-cb8cd022a6d7/2d1f2042-5a61-42bb-8fc1-706c3f3e081c.jpg

This URI can be used directly to access the generated image.

Conceptual Usage Example (Python)

Here's how you might call the Perform High-Quality Image Generation 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 = "b421ae47-a22f-4c35-9360-7d1290b5e620" # Action ID for Perform High-Quality Image Generation

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/KKGcCIfS4huVfI9XhgutsO4x0dZhnEDF8YNGUNOT1yxutgvk/53894527.jpg",
    "width": 917,
    "height": 920,
    "prompt": "This is Eric Draven The Crow Movie 1994 version, Brandon Lee, realistic, 8k, the crow bird, portrait",
    "scheduler": "UniPCMultistep",
    "maximumResolution": 1280,
    "minimumResolution": 1024,
    "shouldResizeImage": True,
    "enhanceFacialRegion": True,
    "inferenceStepsCount": 10,
    "classifierGuidanceScale": 3.5,
    "ipAdapterIntensityScale": 1,
    "negativePromptDescription": "(worst quality, low quality, normal quality, lowres, low details, oversaturated, undersaturated, overexposed, underexposed)+",
    "microDetailAdjustmentWeight": 0.5,
    "controlNetConditioningIntensity": 0.49
}

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 example, replace the placeholder with your actual API key. The action ID and payload structure are defined based on the requirements of the Perform High-Quality Image Generation action.

Conclusion

Integrating high-quality image generation capabilities into your applications using Instant ID Cognitive Actions can greatly enhance visual content and user engagement. With a straightforward API call structure, you can customize image generation to fit your specific needs. Explore further use cases such as creating dynamic visuals for social media, generating content for marketing, or personalizing user experiences in your applications. Start leveraging these powerful tools today!

← Back to All Articles