image-generation

Create Stunning Images Effortlessly with the Image Generation API

11 May 2025
Create Stunning Images Effortlessly with the Image Generation API

The Image Generation And Prediction API is a powerful tool designed for developers looking to create customized images effortlessly. Leveraging advanced LoRA models, this API allows for a wide range of image generation capabilities, including inpainting and image-to-image transformations. By providing various configurable parameters, developers can optimize their image outputs for quality, speed, and specific requirements, streamlining the creative process.

Imagine needing a professional image for a marketing campaign, a unique graphic for a blog, or even personalized artwork for a client—this API can help you achieve all that and more with minimal effort. With its flexibility and precision, the Image Generation And Prediction API is perfect for use cases such as digital marketing, social media content creation, graphic design, and more.

Prerequisites

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

Generate Images with LoRA Models

The primary action within this API is to Generate Images with LoRA Models. This action allows developers to create customized images based on detailed prompts and various input parameters.

Purpose

This action enables users to generate images tailored to specific requirements, making it ideal for projects that demand unique visuals. Whether you are looking to create a realistic portrait, a stylized graphic, or an abstract piece, this action provides the tools necessary to meet your creative vision.

Input Requirements

The input schema for this action requires several parameters:

  • Prompt: A detailed description of the desired image.
  • Image: An input image for transformation (optional).
  • Mask: An image mask for inpainting (optional).
  • Width/Height: Dimensions for the generated image (if aspect ratio is custom).
  • Model: Choice between 'dev' and 'schnell' for inference.
  • Output Format: The desired format for the output image (e.g., jpg, png).
  • Quality: A value between 0 and 100 to define the quality of the generated image.

For example, you might input a prompt describing a professional portrait, alongside specifications for size and output format.

Expected Output

The output of this action will be a URL linking to the generated image, which can be used directly in applications, websites, or for further processing.

Use Cases for this Action

  • Marketing Materials: Quickly generate promotional images that align with brand guidelines.
  • Social Media Content: Create engaging visuals tailored for specific platforms.
  • Custom Artwork: Produce unique designs for clients or personal projects without requiring extensive graphic design skills.
  • Prototyping: Generate images for mockups and presentations, saving time in the development process.
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 = "d5c2916b-2b7b-4653-8b19-ae64621b4907" # Action ID for: Generate Images with LoRA Models

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "goFast": false,
  "prompt": "Professional portrait of Prashant for LinkedIn. He should have a confident and approachable expression, exuding professionalism and charisma. Prashant is dressed in a well-fitted, modern linen greyish-blue business suit with a crisp shirt. The background should be clean and neutral, with soft lighting that highlights his face and brings out his sharp features. The image should convey a sense of sophistication, success, and leadership, ideal for a LinkedIn profile, while maintaining a polished, corporate look. DSLR quality image.",
  "loraScale": 1,
  "imageMegapixels": "1",
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "jpg",
  "imageOutputQuality": 80,
  "inferenceStepCount": 28,
  "additionalLoraScale": 1,
  "imagePromptStrength": 0.7,
  "diffusionGuidanceScale": 2
}

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 Image Generation And Prediction API empowers developers to create stunning, customized images with ease. By understanding the various input options and potential use cases, you can leverage this powerful tool to enhance your projects, improve efficiency, and deliver high-quality visuals. To get started, sign up for your API key and explore the endless possibilities of image generation.

← Back to All Articles