image-generation

Create Stunning Images Effortlessly with Winston's Inpainting and Translation

25 Apr 2025
Create Stunning Images Effortlessly with Winston's Inpainting and Translation

Winston offers developers a powerful tool for generating images through its innovative Cognitive Actions. By leveraging advanced inpainting and image-to-image translation capabilities, Winston simplifies the process of creating high-quality visuals tailored to specific prompts. This service not only enhances creativity but also significantly reduces the time and effort required for image generation. Whether you're designing marketing materials, creating game assets, or developing engaging content, Winston's image generation features can transform your ideas into stunning visuals with ease.

Prerequisites

To get started with Winston's Cognitive Actions, you'll need an API key and a basic understanding of how to make API calls.

Generate Image with Inpainting or Translation

This operation generates images using inpainting or image-to-image translation modes. It supports customization of aspect ratio and resolution, providing options for fast execution and image quality adjustments. The operation is optimized for both speed and quality, using models like 'dev' and 'schnell'.

Input Requirements

To utilize this action, you'll need to provide a structured input containing essential parameters, including:

  • prompt: A text description guiding the image generation.
  • image: (optional) A URI of the input image for translation or inpainting.
  • mask: (optional) A URI of the image mask for inpainting.
  • model: Specifies which model to use for generation.
  • width and height: Define the dimensions of the generated image (only applicable when aspect ratio is 'custom').
  • imageFormat: The desired output format (e.g., jpg, png).
  • outputCount: Number of images to generate (1 to 4).
  • imageQuality: Sets the quality level for output images.
  • Additional parameters for fine-tuning the generation process.

Expected Output

The output will be a URI linking to the generated image based on the provided input. For example:

  • https://assets.cognitiveactions.com/invocations/.../output_image.jpg

Use Cases for this specific action

  • Marketing and Advertising: Create visually appealing graphics for campaigns by generating tailored images that resonate with target audiences.
  • Game Development: Rapidly produce game assets, such as characters and backgrounds, that fit specific design prompts or themes.
  • Content Creation: Enhance blogs, articles, or social media posts with custom images that align with the content's narrative.
  • Visual Storytelling: Generate illustrations that depict specific scenes or characters, making storytelling more engaging.
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 = "13735f7d-680a-4227-b03b-a35705d339b5" # Action ID for: Generate Image with Inpainting or Translation

# 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": "Generate three photos of Winston in a relaxed setting, with friends, sharing experiences.\nWinston is 42 years old, a technology and finance professional, and projects maturity and confidence.",
  "imageFormat": "jpg",
  "outputCount": 1,
  "imageQuality": 80,
  "loraIntensity": 1,
  "enableFastMode": false,
  "imageResolution": "1",
  "promptIntensity": 0.8,
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 3,
  "inferenceIterations": 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

Winston's image generation capabilities through inpainting and translation offer developers a robust solution for creating high-quality visuals with minimal effort. By incorporating this Cognitive Action, you can enhance your projects, whether they are in marketing, game development, or content creation. Start integrating Winston into your workflows today and unlock a world of creative possibilities!

← Back to All Articles