Transform Your Images with Neural Neighbor Style Transfer Cognitive Actions

22 Apr 2025
Transform Your Images with Neural Neighbor Style Transfer Cognitive Actions

In the ever-evolving world of image processing, the ability to blend styles and create visually stunning images is in high demand. The Neural Neighbor Style Transfer (NNST) Cognitive Actions allow developers to harness advanced algorithms for transferring textures and styles from one image to another. This guide will walk you through how to utilize these pre-built actions to enhance your applications with creative image transformations.

Prerequisites

Before you start using the Neural Neighbor Style Transfer Cognitive Actions, ensure that you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making API calls using JSON.

Authentication generally requires passing your API key in the request headers, allowing you to securely access the Cognitive Actions.

Cognitive Actions Overview

Apply Neural Neighbor Style Transfer

The Apply Neural Neighbor Style Transfer action uses the NNST-Opt algorithm to apply a style from one image to another while providing options for color correction and high-resolution output. This action falls under the category of image-processing and is perfect for developers looking to add artistic effects to their applications.

Input

The action requires the following fields in the JSON payload:

  • content: (string) The URI of the content image to be stylized (required).
  • style: (string) The URI of the style image used for transformation (required).
  • alpha: (number) Controls the balance between content preservation and stylization (default: 0.75).
  • colorize: (boolean) Indicates whether color correction should be applied (default: true).
  • highResolution: (boolean) Determines if the output should be high resolution (default: false).
  • useContentLoss: (boolean) Specifies whether to use experimental content loss (default: false).

Example Input:

{
  "alpha": 0.75,
  "style": "https://replicate.delivery/mgxm/af467e03-4bf2-454b-a44b-a8eae8882224/S4.jpg",
  "content": "https://replicate.delivery/mgxm/0f3ee867-ec08-41bc-bfb0-3a4fa1cf8f29/C1.png",
  "colorize": true
}

Output

The action typically returns a URI pointing to the stylized output image. For example:

Example Output:

https://assets.cognitiveactions.com/invocations/c9acd33d-3b16-4d0b-bf75-49da1a217760/bcf3dae9-92ae-4abd-be28-065242aacf02.png

Conceptual Usage Example (Python)

Here’s how you might call the Neural Neighbor Style Transfer action using Python:

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 = "c601ca17-4b95-4b96-ac7b-b8deab21da1b" # Action ID for Apply Neural Neighbor Style Transfer

# Construct the input payload based on the action's requirements
payload = {
    "alpha": 0.75,
    "style": "https://replicate.delivery/mgxm/af467e03-4bf2-454b-a44b-a8eae8882224/S4.jpg",
    "content": "https://replicate.delivery/mgxm/0f3ee867-ec08-41bc-bfb0-3a4fa1cf8f29/C1.png",
    "colorize": True
}

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 snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the "Apply Neural Neighbor Style Transfer" action, and the payload is structured according to the input requirements.

Conclusion

The Neural Neighbor Style Transfer Cognitive Actions provide a powerful way to enhance images by blending styles creatively. By using these actions, developers can easily integrate sophisticated image processing capabilities into their applications. Consider experimenting with different images and settings to discover the full potential of this technology. Happy coding!

← Back to All Articles