image-generation

Create Realistic Human Images Instantly with Cognitive Actions

26 Apr 2025
Create Realistic Human Images Instantly with Cognitive Actions

In the world of digital content creation, the ability to generate realistic human images swiftly and efficiently is a game changer. The "Instant Id" service offers developers a powerful Cognitive Action that allows them to create lifelike images of human faces using a zero-shot identity-preserving generation technique. This means you can generate high-quality images without the need for multiple reference images or extensive training, saving both time and resources.

Imagine scenarios where you need unique human images for marketing materials, character design, or even social media content. The ability to quickly generate tailored images can significantly enhance creativity and productivity, making it ideal for developers working in industries such as gaming, advertising, or online content creation.

Prerequisites

To get started with Instant Id, you'll need an API key for Cognitive Actions and a basic understanding of making API calls.

Generate Realistic Human Image

The "Generate Realistic Human Image" action allows you to create high-quality images of human faces tailored to your specifications. This action addresses the challenge of sourcing original images, enabling you to produce content that meets your specific needs without the hassle of extensive image libraries or copyright concerns.

Input Requirements

To utilize this action, you will need to provide the following input parameters:

  • Image: A URI of the input face image, which serves as the basis for the generated content.
  • Prompt: A descriptive text that guides the generation process, helping to define the style and characteristics of the image.
  • Base Weights: Choose from various model weights to influence the style and quality of the output.
  • Output Format: Specify the desired format for the generated image (webp, jpg, or png).
  • Additional parameters like seed, pose image, and various strength settings for features such as Openpose ControlNet and depth control can also be adjusted to fine-tune the output.

Example Input:

{
  "image": "https://replicate.delivery/pbxt/KIIutO7jIleskKaWebhvurgBUlHR6M6KN7KHaMMWSt4OnVrF/musk_resize.jpeg",
  "prompt": "analog film photo of a man. faded film, desaturated, 35mm photo, grainy, vignette, vintage, Kodachrome, Lomography, stained, highly detailed, found footage, masterpiece, best quality",
  "baseWeights": "protovision-xl-high-fidel",
  "imageFormat": "webp",
  "numberOfOutputs": 1
}

Expected Output

The expected output will be a URI link to the generated image, which will reflect the characteristics defined in your input prompt.

Example Output:

https://assets.cognitiveactions.com/invocations/8bd5c536-a60c-4e16-a4a4-cd63e6f86eee/03f35b0a-07f3-4509-9acb-d2bec0bf9d9d.webp

Use Cases for this Action

  • Marketing Campaigns: Create unique and engaging human images for advertisements without worrying about copyright issues.
  • Character Design: Generate diverse characters for games or animations, allowing for rapid prototyping and iteration.
  • Content Creation: Produce custom images for blogs, articles, or social media posts, enhancing engagement and visual appeal.
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 = "82df2306-c2d7-42a7-b0d0-ec841014dd2d" # Action ID for: Generate Realistic Human Image

# 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/KIIutO7jIleskKaWebhvurgBUlHR6M6KN7KHaMMWSt4OnVrF/musk_resize.jpeg",
  "prompt": "analog film photo of a man. faded film, desaturated, 35mm photo, grainy, vignette, vintage, Kodachrome, Lomography, stained, highly detailed, found footage, masterpiece, best quality",
  "enableLcm": false,
  "poseImage": "https://replicate.delivery/pbxt/KJmFdQRQVDXGDVdVXftLvFrrvgOPXXRXbzIVEyExPYYOFPyF/80048a6e6586759dbcb529e74a9042ca.jpeg",
  "baseWeights": "protovision-xl-high-fidel",
  "imageFormat": "webp",
  "poseStrength": 0.4,
  "cannyStrength": 0.3,
  "depthStrength": 0.5,
  "guidanceScale": 5,
  "outputQuality": 80,
  "schedulerType": "EulerDiscreteScheduler",
  "negativePrompt": "(lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch, deformed, mutated, cross-eyed, ugly, disfigured (lowres, low quality, worst quality:1.2), (text:1.2), watermark, painting, drawing, illustration, glitch,deformed, mutated, cross-eyed, ugly, disfigured",
  "numberOfOutputs": 1,
  "imageAdapterScale": 0.8,
  "numInferenceSteps": 30,
  "enablePoseControlnet": true,
  "enhanceNonfaceRegion": true,
  "enableCannyControlnet": false,
  "enableDepthControlnet": false,
  "faceDetectionInputWidth": 640,
  "faceDetectionInputHeight": 640,
  "identityNetConditioningScale": 0.8,
  "latentConsistencyGuidanceScale": 1.5,
  "latentConsistencyInferenceSteps": 5
}

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 Instant Id service provides developers with a powerful tool for generating realistic human images quickly and efficiently. With its flexibility and ease of use, it opens up numerous possibilities for content creation across various industries. Whether you're looking to enhance your marketing materials or create unique characters for your next project, this Cognitive Action can streamline your workflow and elevate your creative output. Start integrating Instant Id into your applications today and unlock new creative potential!

← Back to All Articles