Unlock Image Generation with the nikbullx/firstmodel Cognitive Actions

25 Apr 2025
Unlock Image Generation with the nikbullx/firstmodel Cognitive Actions

In the rapidly evolving landscape of artificial intelligence and machine learning, the ability to generate and manipulate images has become increasingly valuable for developers. The nikbullx/firstmodel API offers a powerful Cognitive Action called Generate Image With Inpainting, which allows you to create and refine images based on specific input parameters. This capability not only enhances creativity but also streamlines workflows in applications that require visual content generation.

Prerequisites

Before diving into the use of the Cognitive Actions provided by the nikbullx/firstmodel, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • A basic understanding of JSON and how to work with APIs.
  • Familiarity with Python for executing the API calls.

Authentication typically involves passing your API key in the request headers to authorize the action.

Cognitive Actions Overview

Generate Image With Inpainting

Description:
This operation generates images by utilizing image inpainting to refine or complete an image based on input parameters. It supports various customization options such as aspect ratio, dimensions, and output formats. Users can also provide specific prompts for image generation and adjust different LoRA weights for enhanced quality or speed.

Category: Image Generation

Input

The input schema includes several required and optional fields:

  • prompt (required): A string that describes the image to be generated.
  • mask (optional): URI of an image mask for inpainting mode.
  • image (optional): URI of the input image for image-to-image or inpainting modes.
  • model (optional): The model to run inference (dev or schnell).
  • ratio (optional): Aspect ratio for the generated image.
  • width (optional): Width of the generated image in pixels.
  • height (optional): Height of the generated image in pixels.
  • format (optional): Output format of the image (webp, jpg, png).
  • quality (optional): Quality of the output images (0 to 100).
  • loraScale (optional): Determines the strength of the main LoRA application.
  • speedMode (optional): Enables faster predictions.
  • outputCount (optional): Specifies the number of outputs to generate (1-4).
  • guidanceScale (optional): Guidance scale for the diffusion process.
  • numInferenceSteps (optional): Number of denoising steps for generating the image.

Example Input

{
  "model": "dev",
  "ratio": "16:9",
  "format": "webp",
  "prompt": "Dozens of Ehang216 flying like a parade in the sky in the sky above the field. We see them in detail, and we see the passengers inside through the windshield. We watch this from above. Sunny day.",
  "quality": 80,
  "loraScale": 1,
  "speedMode": false,
  "megapixels": "1",
  "outputCount": 1,
  "guidanceScale": 3,
  "promptIntensity": 0.8,
  "numInferenceSteps": 28,
  "additionalLoraIntensity": 1
}

Output

The output of this action typically consists of a URL pointing to the generated image. Here's an example of a successful output:

[
  "https://assets.cognitiveactions.com/invocations/3116104f-a08d-42f8-ad3d-5a38fdc9794d/e6c75b45-c49e-40ae-b0fb-4e12aa04beb9.webp"
]

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to execute the Generate Image With Inpainting action:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "9a41f11d-1eba-4f0f-aefe-ed92fd71d0f8" # Action ID for Generate Image With Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "ratio": "16:9",
    "format": "webp",
    "prompt": "Dozens of Ehang216 flying like a parade in the sky above the field. We see them in detail, and we see the passengers inside through the windshield.",
    "quality": 80,
    "loraScale": 1,
    "speedMode": False,
    "megapixels": "1",
    "outputCount": 1,
    "guidanceScale": 3,
    "promptIntensity": 0.8,
    "numInferenceSteps": 28,
    "additionalLoraIntensity": 1
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload} # Hypothetical structure
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    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: {e.response.text}")

In this code, replace the placeholder API key and endpoint with your actual values. The input payload is structured according to the action's requirements, and the response is processed to retrieve the generated image URL.

Conclusion

The nikbullx/firstmodel Cognitive Actions provide a powerful tool for developers looking to integrate sophisticated image generation capabilities into their applications. By leveraging the Generate Image With Inpainting action, you can create unique and high-quality images tailored to your specific needs. Explore the possibilities and enhance your projects with this cutting-edge technology!

← Back to All Articles