Create Stunning Images with the Portra-800 Cognitive Actions

23 Apr 2025
Create Stunning Images with the Portra-800 Cognitive Actions

In the world of image generation, the ability to create visually stunning and contextually rich images is a powerful tool for developers. The shapestudio/portra-800-flux API offers a unique set of Cognitive Actions that leverage state-of-the-art models to generate images inspired by Kodak Portra 800. This blog post will guide you through integrating the Cognitive Action to generate images, highlighting its capabilities and providing practical code examples.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON format and Python programming.
  • Familiarity with handling API requests and responses.

Authentication generally involves passing the API key in the headers of your requests, which will authenticate your application to utilize the Cognitive Actions.

Cognitive Actions Overview

Generate Portra-800 Inspired Image

This action allows you to create an image inspired by Kodak Portra 800 using the Flux Lora model. You can customize various aspects of the image, including resolution, format, and style intensity, optimizing for either speed or quality.

Category: Image Generation

Input

The input schema for the Generate Portra-800 Inspired Image action includes several parameters. Below are the key required and optional fields:

  • Required:
    • prompt: A textual description that guides the image generation (e.g., "A cup of coffee where the steam forms a cloud...").
  • Optional:
    • mask: URI for an image mask (used in inpainting).
    • seed: Integer value for reproducibility.
    • image: URI for an input image (for inpainting).
    • model: Select either "dev" or "schnell" for inference.
    • width and height: Custom dimensions for the image.
    • goFast: Enable fast mode for quicker predictions.
    • aspectRatio: Aspect ratio setting (e.g., "1:1").
    • outputFormat: Image file format (e.g., "webp", "jpg", "png").
    • guidanceScale: Adjusts the influence of the prompt.
    • numberOfOutputs: Specify how many images to generate.

Here’s an example input JSON payload:

{
  "model": "dev",
  "prompt": "A cup of coffee where the steam forms a cloud, raining tiny droplets back into the cup, in a self-sustaining cycle.",
  "loraScale": 0.86,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 38
}

Output

Upon successful execution, the action returns a URL to the generated image. Here's an example of the output:

[
  "https://assets.cognitiveactions.com/invocations/85109e2d-0946-4481-a0b0-869b118438fd/b3275348-ef5a-449d-97c0-aea68d7cef3f.webp"
]

This URL points to the newly created image based on your provided prompt and settings.

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the Generate Portra-800 Inspired Image 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 = "9969d827-b799-4a68-8d1b-633ce5008bf5"  # Action ID for Generate Portra-800 Inspired Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "A cup of coffee where the steam forms a cloud, raining tiny droplets back into the cup, in a self-sustaining cycle.",
    "loraScale": 0.86,
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "guidanceScale": 3.5,
    "outputQuality": 80,
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 38
}

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 placeholders with your API key and the action ID for the image generation.
  • The payload is structured according to the action's input requirements.
  • The response will contain the URL of the generated image.

Conclusion

The Generate Portra-800 Inspired Image action from the shapestudio/portra-800-flux API empowers developers to create visually captivating images based on custom prompts and settings. By integrating this action, you can enhance your applications with advanced image generation capabilities, opening up new creative possibilities.

Consider experimenting with different prompts and settings to explore the full potential of this action. Happy coding!

← Back to All Articles