Create Stunning NPC Textures with the Texture Portrait Cognitive Actions

24 Apr 2025
Create Stunning NPC Textures with the Texture Portrait Cognitive Actions

In the realm of game development, visual storytelling is paramount. The marcodemutiis/texture-portrait API offers a powerful Cognitive Action that allows developers to generate NPC texture images tailored to their specific needs. This action leverages advanced techniques, enabling customizable settings for output quality, size, and artistic style. By using these pre-built actions, you can significantly streamline the process of creating unique character textures for your games.

Prerequisites

Before diving into the integration of Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of how to make API calls, particularly using JSON payloads.
  • Familiarity with Python for executing requests to the Cognitive Actions endpoint.

Authentication typically involves passing the API key in the request headers, allowing you to securely access the desired functionality.

Cognitive Actions Overview

Generate NPC Texture Images

The Generate NPC Texture Images action is designed to create images that mimic the styles typical of NPCs in video games. It allows for extensive customization, enabling developers to define various parameters to suit their creative vision.

Purpose

This action generates high-quality NPC texture images based on a provided text prompt and various customizable settings.

Input

The following fields are required and optional based on the input schema:

  • Required:
    • prompt: string - This is the text prompt that guides the image generation. Example: "a portrait of a person in the style of texturePortraitTOK".
  • Optional:
    • mask: string - URI of an image mask for inpainting mode.
    • seed: integer - A random seed for generating reproducible images.
    • image: string - URI of an input image for image-to-image transformations.
    • width: integer - Width of the generated image (must be a multiple of 16).
    • height: integer - Height of the generated image (must be a multiple of 16).
    • goFast: boolean - Enables fast generation mode.
    • aspectRatio: string - Defines the aspect ratio of the image.
    • numOutputs: integer - Specifies how many images to generate (1 to 4).
    • outputFormat: string - Format of the output images (webp, jpg, png).
    • guidanceScale: number - Affects image fidelity based on diffusion guidance.
    • outputQuality: integer - Quality of output images (0 to 100).
    • ...other optional fields...
Example Input
{
  "width": 1440,
  "goFast": false,
  "height": 1440,
  "prompt": "a portrait of a person in the style of texturePortraitTOK",
  "loraScale": 1.27,
  "numOutputs": 4,
  "aspectRatio": "1:1",
  "outputFormat": "png",
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "approxMegapixels": "1",
  "numInferenceSteps": 28
}

Output

The action returns an array of URLs pointing to the generated images. Here’s an example of the output:

Example Output
[
  "https://assets.cognitiveactions.com/invocations/a56b8f7d-28a1-40d6-a83f-3e5cb5f589f5/a4383bc6-7d73-4f1e-9a54-28e8d6ad4e2e.png",
  "https://assets.cognitiveactions.com/invocations/a56b8f7d-28a1-40d6-a83f-3e5cb5f589f5/7dcbf51b-5549-4999-9559-e554d812240a.png",
  "https://assets.cognitiveactions.com/invocations/a56b8f7d-28a1-40d6-a83f-3e5cb5f589f5/c4b78f31-4535-49ac-a797-86696114d96a.png",
  "https://assets.cognitiveactions.com/invocations/a56b8f7d-28a1-40d6-a83f-3e5cb5f589f5/df47a894-90cd-41ec-b811-a2619fe6f2d0.png"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python snippet demonstrating how to call the Cognitive Actions endpoint:

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 = "52c04ba5-8ef0-450f-abca-a06830910e82"  # Action ID for Generate NPC Texture Images

# Construct the input payload based on the action's requirements
payload = {
    "width": 1440,
    "goFast": False,
    "height": 1440,
    "prompt": "a portrait of a person in the style of texturePortraitTOK",
    "loraScale": 1.27,
    "numOutputs": 4,
    "aspectRatio": "1:1",
    "outputFormat": "png",
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "approxMegapixels": "1",
    "numInferenceSteps": 28
}

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 for generating NPC textures is specified, and the input payload is structured according to the requirements outlined earlier.

Conclusion

The Generate NPC Texture Images action from the marcodemutiis/texture-portrait API provides developers with a robust tool for creating unique game textures. With customization options for quality, size, and style, you can easily integrate this functionality into your projects, enhancing the visual appeal of your NPCs significantly.

Consider experimenting with the various parameters to achieve the best results for your specific needs. Embrace the creativity that this API unlocks, and elevate your game development experience!

← Back to All Articles