Generate Stunning Images with Cognitive Actions for surajop06/suraj06

22 Apr 2025
Generate Stunning Images with Cognitive Actions for surajop06/suraj06

In the world of image generation, having access to powerful tools can elevate your applications and creative projects significantly. The surajop06/suraj06 API offers a remarkable set of Cognitive Actions that enable developers to generate high-quality images using inpainting mode. These pre-built actions streamline the process of creating stunning visuals, allowing for customization in dimensions, format, and output quality. Whether you’re looking to enhance artistic projects or integrate image generation features into your applications, these actions provide the flexibility and efficiency needed.

Prerequisites

Before you start using the Cognitive Actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic familiarity with making API calls and handling JSON data.

For authentication, you will typically pass your API key in the headers of your requests, allowing you to securely access the desired actions.

Cognitive Actions Overview

Generate Image with Inpainting

This action allows you to generate high-quality images using inpainting. It supports customization of dimensions, formats, and the number of outputs, while also accommodating LoRA applications and custom aspect ratios.

  • Category: image-generation

Input

The input for this action requires a JSON object that includes the following fields:

  • Required:
    • prompt: Textual prompt guiding the image generation (e.g., "suraj").
  • Optional:
    • mask: URI of the image mask for inpainting.
    • seed: Integer for reproducible outputs.
    • image: URI of the input image for inpainting.
    • width: Width of the generated image (only if aspect_ratio is custom).
    • height: Height of the generated image (only if aspect_ratio is custom).
    • goFast: Enable fast predictions.
    • extraLora: Additional LoRA weights.
    • loraScale: Adjusts the intensity of the main LoRA application.
    • modelType: Selects the model for inference (dev or schnell).
    • numOutputs: Number of images to generate (1-4).
    • guidanceScale: Influences the diffusion process.
    • outputQuality: Sets the quality of output images.
    • extraLoraScale: Controls the intensity of the extra LoRA.
    • promptStrength: Influences prompt during modification.
    • approxMegapixels: Estimates the image's megapixel count.
    • outputFileFormat: Determines the output format (webp, jpg, png).
    • aspectRatioOption: Specifies the aspect ratio.
    • numInferenceSteps: Sets the number of denoising steps.
    • disableSafetyChecker: Enables/disables the safety checker.

Example Input:

{
  "image": "https://replicate.delivery/pbxt/Livkf07JtmJbAlu4mFIr1jrk12VqpcM7XU6hzvERmRhWfnkY/out-0%20%285%29.png",
  "prompt": "suraj",
  "loraScale": 1,
  "modelType": "dev",
  "numOutputs": 1,
  "guidanceScale": 3.5,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "outputFileFormat": "webp",
  "aspectRatioOption": "1:1",
  "numInferenceSteps": 28
}

Output

The action typically returns a list of URLs pointing to the generated images.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/7c488969-8fac-42af-8515-4754da716d40/229d5189-194c-43e9-987c-df22aa5ccae4.webp"
]

Conceptual Usage Example (Python)

Here’s a conceptual example of how you might call this 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 = "532d5ab4-e030-4771-aa44-e0678ea78d27"  # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/Livkf07JtmJbAlu4mFIr1jrk12VqpcM7XU6hzvERmRhWfnkY/out-0%20%285%29.png",
    "prompt": "suraj",
    "loraScale": 1,
    "modelType": "dev",
    "numOutputs": 1,
    "guidanceScale": 3.5,
    "outputQuality": 90,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "outputFileFormat": "webp",
    "aspectRatioOption": "1:1",
    "numInferenceSteps": 28
}

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 code snippet, you replace the action ID and input payload as needed. The endpoint URL and request structure are illustrative, focusing on how to build and send the request.

Conclusion

The Generate Image with Inpainting action in the surajop06/suraj06 API provides developers with a robust tool for creating stunning images tailored to their specifications. With extensive customization options, this action is perfect for a variety of applications, from artistic endeavors to practical integrations. Explore the possibilities and consider how you can leverage this powerful API to enhance your projects!

← Back to All Articles