image-generation

Create Stunning Custom Images with Imagineforest69

25 Apr 2025
Create Stunning Custom Images with Imagineforest69

Imagineforest69 offers a powerful suite of Cognitive Actions that enable developers to generate customized images tailored to specific needs. With the ability to utilize advanced models for image-to-image transformations and inpainting tasks, this service simplifies the process of creating visually appealing content. Whether you are looking to enhance marketing materials, develop unique artwork, or create personalized graphics for applications, Imagineforest69 streamlines image generation with a range of customizable options.

Common use cases include generating images for social media campaigns, creating artistic visuals for websites, or producing unique assets for games and applications. The flexibility in input parameters allows developers to fine-tune their results, ensuring that the final images meet their specific requirements.

Prerequisites

To get started with Imagineforest69, you will need a valid Cognitive Actions API key and a basic understanding of making API calls.

Generate Image with Mask and Options

The "Generate Image with Mask and Options" action allows developers to create tailored images using either the 'dev' or 'schnell' models. This action is particularly useful for image inpainting and image-to-image tasks, providing a high level of customization in the output.

Purpose

This action solves the problem of generating high-quality images that meet specific artistic and technical requirements. By allowing the use of masks and various options, it enables users to produce images that are not only visually striking but also aligned with their intended vision.

Input Requirements

The input for this action requires a JSON object, where the key parameters include:

  • prompt: A detailed text description that guides the image generation.
  • image (optional): A URI of the input image for transformation.
  • mask (optional): A URI of the mask used for inpainting.
  • Additional parameters include width, height, outputCount, outputFormat, and several model-specific options like loraScale and guidanceScale.

Expected Output

The output will be an array of generated image URLs in the specified format (e.g., webp, jpg, png), tailored to the input specifications provided.

Use Cases for this specific action

  • Marketing Materials: Create unique images for advertisements that capture audience attention.
  • Game Development: Generate character designs or environments that are distinct and visually appealing.
  • Artistic Projects: Produce artwork that combines different styles, allowing for creative expression in digital formats.
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 = "32baf088-3a80-4159-b2b8-0126fe686cda" # Action ID for: Generate Image with Mask and Options

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "prompt": "on voit tout son corps. Séductrice alien avec des longs cheveux roses lisses, un visage fin, des clavicules apparentes, une forte poitrine, des seins ronds, des hanches fines, des jambes fines, des chaussures à talon.\nAvec Beaucoup de maquillage, du fare à paupière, du rouge à lèvre bleu, elle est très séduisante hypnotique.  \nEn tenue moulante en latex rose. \nELLE EST ALLONGEE SUR UN LIT.\nDans un vaisseau spatial magique avec des aliens enarrière-plan.\nIl y a beaucoup de néons et de lumières, avec un écran TV hypnotique.\nElle a une main dans les cheveux et fixe la caméra d’un regard séduisant hypnotique\nStyle ultra-réaliste photo séduisant hypnotique.",
  "loraScale": 0.64,
  "outputCount": 4,
  "outputFormat": "webp",
  "guidanceScale": 2.98,
  "outputQuality": 100,
  "inferenceModel": "dev",
  "promptStrength": 0.44,
  "imageAspectRatio": "16:9",
  "numInferenceSteps": 28,
  "additionalLoraScale": -0.04
}

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 Mask and Options" action of Imagineforest69 provides developers with a powerful tool for creating customized images that meet diverse requirements. By leveraging the flexibility of input parameters and the capabilities of advanced models, you can generate stunning visuals for a wide range of applications. Explore this action further to elevate your projects and enhance your creative outputs.

← Back to All Articles