Interpolating Images Like a Pro with the piyushk52/ad_3_img_interpolation Actions

22 Apr 2025
Interpolating Images Like a Pro with the piyushk52/ad_3_img_interpolation Actions

In the world of image processing, the ability to creatively blend and interpolate images can lead to stunning visual results. The piyushk52/ad_3_img_interpolation API offers developers a powerful Cognitive Action that allows for advanced image interpolation between three distinct images. This capability not only enhances the creative potential of applications but also simplifies the development process with pre-built actions that save time and effort.

Prerequisites

Before diving into the action, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Familiarity with making HTTP requests and handling JSON payloads.

Authentication typically involves passing the API key in the headers of your requests. This ensures secure access to the actions provided by the service.

Cognitive Actions Overview

Interpolate Images with Model

Description:
This action enables developers to interpolate between three images using advanced image models. By specifying models, prompts, and styles, you can control the output, resulting in either realistic or stylized visuals.

Category: Image Processing

Input:

The input schema requires the following fields:

  • imageOne (string): URL of the first input image (must be a valid URI).
  • imageTwo (string): URL of the second input image (must be a valid URI).
  • imageThree (string): URL of the third input image (must be a valid URI).
  • seed (integer, optional): Integer seed value for sampling. Use -1 for a random seed (default: -1).
  • prefix (string, optional): A prompt prefix setting context or style (default: "Water color painting").
  • modelModule (string, optional): Model module for processing; defaults to "Counterfeit-V3.0_fp32.safetensors".
  • motionModel (string, optional): Choose a motion model checkpoint file (default: "mm_sd_v15_v2.ckpt").
  • configuration (number, optional): Configuration value for interpolation sampler (default: 8, range: 0-30).
  • samplingSteps (integer, optional): Number of sampling steps to perform (default: 30).
  • negativePrompt (string, optional): Defines undesirable traits to avoid in the result (default: "(worst quality, low quality:1.2)").
  • positivePrompt (string, optional): Defines traits to encourage in the result (default: "0_griffith from berserk:16_griffith from berserk:24_griffith from berserk").
  • imageDimensions (string, optional): Select dimensions for the output image (default: "512x512").

Example Input:

{
  "seed": -1,
  "prefix": "Anime style",
  "imageOne": "https://replicate.delivery/pbxt/JjWuKjMu5NuXGXkM8Wzv8SYSjzRYToo5hilDzQLsQ6XEWnz9/image-011.jpg",
  "imageTwo": "https://replicate.delivery/pbxt/JjWuK0fhKzrSlGzk4UmUahAkXjOcLAXTFqHRdHs9QCfv5FTV/image-012.jpg",
  "imageThree": "https://replicate.delivery/pbxt/JjWuK4QPGqGoGGcpT8COOcfuzGPhOmIt4PENjsou2x51O386/image-013.jpg",
  "modelModule": "Counterfeit-V3.0_fp32.safetensors",
  "motionModel": "mm_sd_v15_v2.ckpt",
  "configuration": 8,
  "samplingSteps": 30,
  "negativePrompt": "(worst quality, low quality:1.2)",
  "positivePrompt": "0_griffith from berserk:16_griffith from berserk:24_griffith from berserk",
  "imageDimensions": "512x512"
}

Output:

The action typically returns a URL to the generated image or video, showcasing the interpolated results. For example:

https://assets.cognitiveactions.com/invocations/5501538a-3814-4a0f-af98-63066796820b/a919e064-4d6b-4c53-a1ab-3f3f0c47811c.mp4

Conceptual Usage Example (Python): Below is a conceptual implementation of how you can invoke the image interpolation action with the required input structure.

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 = "062cc5ac-41af-4ae2-bcf1-4379ddf4f7fd" # Action ID for Interpolate Images with Model

# Construct the input payload based on the action's requirements
payload = {
    "seed": -1,
    "prefix": "Anime style",
    "imageOne": "https://replicate.delivery/pbxt/JjWuKjMu5NuXGXkM8Wzv8SYSjzRYToo5hilDzQLsQ6XEWnz9/image-011.jpg",
    "imageTwo": "https://replicate.delivery/pbxt/JjWuK0fhKzrSlGzk4UmUahAkXjOcLAXTFqHRdHs9QCfv5FTV/image-012.jpg",
    "imageThree": "https://replicate.delivery/pbxt/JjWuK4QPGqGoGGcpT8COOcfuzGPhOmIt4PENjsou2x51O386/image-013.jpg",
    "modelModule": "Counterfeit-V3.0_fp32.safetensors",
    "motionModel": "mm_sd_v15_v2.ckpt",
    "configuration": 8,
    "samplingSteps": 30,
    "negativePrompt": "(worst quality, low quality:1.2)",
    "positivePrompt": "0_griffith from berserk:16_griffith from berserk:24_griffith from berserk",
    "imageDimensions": "512x512"
}

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 the placeholder API key with your actual key. The action ID corresponds to the image interpolation action. The input payload is structured according to the action's requirements.

Conclusion

The piyushk52/ad_3_img_interpolation Cognitive Action provides an efficient way to interpolate images with a high degree of control over the output. By leveraging this powerful tool, developers can enhance their applications with visually striking imagery that meets various creative requirements. As a next step, consider exploring how to integrate this action into your projects or experimenting with different model and prompt combinations to achieve unique results.

← Back to All Articles