Create Stunning Images with Gstreet's Inpainting Action

26 Apr 2025

In today's digital landscape, the ability to generate visually appealing images quickly and efficiently is a game-changer for developers and artists alike. Gstreet offers a powerful set of Cognitive Actions, including the innovative Generate Image with Inpainting feature. This action leverages advanced inpainting techniques to create detailed images based on customizable settings, making it ideal for a variety of applications, from content creation to graphic design.

Imagine having the capability to transform existing images or fill in missing parts seamlessly with just a few parameters. This is not only a time-saver but also opens up endless creative possibilities. Whether you are looking to generate unique artwork, enhance visual content for marketing, or build engaging applications that require dynamic image creation, Gstreet's inpainting action can be your go-to solution.

Prerequisites

To get started with Gstreet's Cognitive Actions, you'll need an API key and a basic understanding of making API calls. This will enable you to effectively integrate the image generation capabilities into your projects.

Generate Image with Inpainting

The Generate Image with Inpainting action allows you to create detailed images by specifying prompts and adjusting various parameters. This action is particularly useful for tasks that require image-to-image transformations or filling in gaps in existing images.

Purpose

This action solves the problem of generating high-quality images that can be tailored to specific needs. Whether you want to create a new visual from scratch or enhance an existing one, inpainting offers flexibility and creative control.

Input Requirements

The input for this action is a structured request that includes essential parameters such as:

prompt: A descriptive string guiding the image generation (e.g., "GSTREET 10 indian people on a scooter with an ukraine flag. sand and dirty in mumbai").
mask (optional): A URI pointing to an image mask for inpainting.
image (optional): A URI for an existing image you wish to transform.
Various settings like width, height, aspectRatio, and outputCount to customize the output.

Expected Output

The output will be a generated image based on the input parameters, returned in the specified format (e.g., webp, jpg, png). For example, a successful request could yield a link to a newly created image, like:

https://assets.cognitiveactions.com/invocations/83c67417-3ef3-464a-9f69-73a5984cfcc5/98c0db9b-585c-4283-ad71-8d6f7758d328.webp.

Use Cases for this Specific Action

Content Creation: Create unique visuals for blogs, social media posts, or marketing materials.
Art Projects: Generate artwork for digital galleries or personal projects by specifying unique prompts.
Game Development: Design characters or environments with custom images based on in-game prompts.
E-commerce: Enhance product images by filling in backgrounds or creating composite visuals.


```python
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 = "67ff9199-fd9f-4e3e-8b25-d2ee72344e93" # 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 = {
  "model": "dev",
  "prompt": " GSTREET 10 indian people on a scooter with an ukraine flag. sand and dirty in mumbai",
  "megapixels": "1",
  "aspectRatio": "1:1",
  "outputCount": 1,
  "promptPower": 0.8,
  "outputFormat": "webp",
  "loraIntensity": 1,
  "outputQuality": 80,
  "accelerateMode": false,
  "guidanceIntensity": 3,
  "inferenceStepsCount": 28,
  "additionalLoraIntensity": 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
Gstreet's **Generate Image with Inpainting** action provides developers with a robust tool for creating stunning images with ease. By utilizing customizable parameters and advanced inpainting techniques, you can streamline your image generation process and unlock new creative opportunities. Whether for personal projects or professional applications, the potential use cases are vast.

As you explore the capabilities of Gstreet, consider experimenting with different prompts and settings to discover the full range of possibilities. Start integrating this powerful action into your projects today and elevate your visual content to the next level!