image-processing

Create Stunning Images with Inpainting Using the Gjoyce Model

25 Apr 2025
Create Stunning Images with Inpainting Using the Gjoyce Model

In the world of digital content creation, the ability to generate high-quality images quickly and efficiently is a game changer. The Gjoyce Model offers a powerful Cognitive Action known as "Generate Image with Inpainting," which leverages advanced inpainting techniques to produce stunning visuals tailored to your specific needs. This action allows developers to create images with customizable parameters, making it easier than ever to achieve desired artistic effects and enhance visual storytelling.

Imagine needing to produce unique images for marketing campaigns, social media, or personal projects without the hassle of traditional graphic design tools. With the Gjoyce Model, you can automate and streamline image generation, saving time while ensuring high quality. Whether you want to create content for a blog, design an advertisement, or simply explore creative possibilities, this action opens up a world of opportunities.

Prerequisites

Before diving into the implementation, ensure you have a Cognitive Actions API key and a basic understanding of making API calls.

Generate Image with Inpainting

The "Generate Image with Inpainting" action is designed to create images based on user-defined parameters, offering extensive control over the final output. This action is perfect for developers looking to generate unique images that align with specific themes or concepts.

Purpose

This action addresses the need for customizable image creation, allowing you to generate images with specific attributes, styles, and content. It is particularly useful for projects that require unique visuals, such as marketing materials, digital art, or personalized media.

Input Requirements

To utilize this action, you need to provide a structured input consisting of several optional and required parameters:

  • prompt (required): A descriptive text that guides the image generation.
  • mask: An image mask for inpainting mode.
  • image: An input image for inpainting.
  • width and height: Define the dimensions of the generated image.
  • aspectRatio: Set the aspect ratio of the image.
  • inferenceModel: Choose between 'dev' for quality or 'schnell' for speed.
  • outputQuantity: Specify how many images to generate.
  • loraScale, guidanceScale, promptStrength, and others: Control various attributes of the image generation process.

Expected Output

The output will be a URL or a set of URLs pointing to the generated images based on the specified parameters. For example, you might receive links to two images that fulfill the requirements set by your prompt.

Use Cases for this Specific Action

  • Marketing Campaigns: Create tailored images that resonate with your target audience, enhancing promotional materials.
  • Social Media Content: Generate eye-catching visuals for posts, stories, and ads that stand out in users' feeds.
  • Personal Projects: Explore creative ideas or concepts by generating unique images that reflect your artistic vision.
  • Game Development: Produce character designs or environment art quickly to visualize concepts before finalizing them.
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 = "023c321d-9049-4699-a19e-bfe2f630e7fe" # Action ID for: Generate Image with Inpainting

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "prompt": "A GJPRT stylish and confident black woman sitting down inside a modern, chic hair salon chair, body straight and legs crossed. The salon features sleek black chairs, mirrors with geometric black backdrops, and an organized display of hair extensions in the background. The woman is dressed in elegant, fashionable attire that complements the salon’s upscale vibe. She poses with a happy face, looking towards the camera. The lighting is soft and flattering, highlighting both the model and the sophisticated salon space. The atmosphere is inviting and clean, perfect for promoting high-quality hair services.",
  "loraScale": 1,
  "aspectRatio": "16:9",
  "imageFormat": "png",
  "imageQuality": 90,
  "guidanceScale": 3.5,
  "inferenceModel": "dev",
  "outputQuantity": 2,
  "promptStrength": 0.8,
  "numInferenceSteps": 40,
  "additionalLoraScale": 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

The "Generate Image with Inpainting" action from the Gjoyce Model offers developers an innovative way to create customized images efficiently. By leveraging this Cognitive Action, you can enhance your projects with unique visuals tailored to your specifications, saving time and resources in the creative process. Start exploring the possibilities today, and see how you can integrate this powerful tool into your development workflow!

← Back to All Articles