Generate Stunning Images with sofoo1992/tuiwen-v1 Cognitive Actions

23 Apr 2025
Generate Stunning Images with sofoo1992/tuiwen-v1 Cognitive Actions

In the world of application development, integrating powerful image generation capabilities can enhance user engagement and creativity. The sofoo1992/tuiwen-v1 API offers a set of Cognitive Actions that allow developers to generate custom images based on specific prompts and settings. These pre-built actions simplify the process of creating unique visuals tailored to your application's needs, making it easier to deliver innovative experiences.

Prerequisites

Before you can utilize the Cognitive Actions from the sofoo1992/tuiwen-v1 API, ensure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON and HTTP requests to structure your inputs correctly.

Authentication typically involves passing the API key in the headers of your requests. This allows you to securely access the image generation capabilities offered by the API.

Cognitive Actions Overview

Generate Custom Image

The Generate Custom Image action allows you to create images based on specific prompts and customizable settings such as width, height, and guidance scale. It provides flexibility through different schedulers and the ability to exclude certain elements from the generated image.

Input

The input for this action is a JSON object with the following schema:

{
  "seed": 99,
  "width": 768,
  "height": 768,
  "prompt": "1girl, long hair, blossom",
  "scheduler": "DDIM",
  "guidanceScale": 7.5,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 30
}
  • seed (integer): A random seed for reproducibility. Leave blank to use a random seed.
  • width (integer): The width of the output image, with options ranging from 512 to 1024. Default is 768.
  • height (integer): The height of the output image, also ranging from 512 to 1024. Default is 768.
  • prompt (string): The input prompt that specifies elements to include in the image.
  • scheduler (string): Choose a scheduler for processing from options like "DDIM", "K_EULER", etc. Default is "DPMSolverMultistep".
  • guidanceScale (number): A scale factor for classifier-free guidance, ranging from 1 to 20. Default is 7.5.
  • negativePrompt (string, optional): Specify elements to exclude from the output image.
  • numberOfOutputs (integer): The number of images to generate (1 to 4). Default is 1.
  • numberOfInferenceSteps (integer): The number of denoising steps (1 to 500). Default is 50.

Output

The output for this action is typically a JSON array containing URLs of the generated images. For example:

[
  "https://assets.cognitiveactions.com/invocations/6c539a5d-342f-4d47-acb4-1216ffd834be/192bdcbc-e694-4353-b1e1-54645ef17bc5.png"
]

This output provides direct links to the images generated by your request.

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the Generate Custom Image action using a hypothetical Cognitive Actions execution 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 = "3d064684-93f2-40d1-80ca-600363e01d10"  # Action ID for Generate Custom Image

# Construct the input payload based on the action's requirements
payload = {
    "seed": 99,
    "width": 768,
    "height": 768,
    "prompt": "1girl, long hair, blossom",
    "scheduler": "DDIM",
    "guidanceScale": 7.5,
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 30
}

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 snippet, replace the placeholder API key and endpoint with your actual values. The action ID and the input payload are structured according to the requirements of the Generate Custom Image action.

Conclusion

The sofoo1992/tuiwen-v1 Cognitive Actions provide a powerful way to integrate custom image generation into your applications. By leveraging these actions, developers can create unique and tailored images easily, enhancing the user experience. Consider exploring additional use cases, such as dynamic content creation or personalized media, to further harness the potential of these Cognitive Actions in your projects.

← Back to All Articles