Create Stunning Images with the lucataco/hunyuandit-v1.1 Cognitive Action

21 Apr 2025
Create Stunning Images with the lucataco/hunyuandit-v1.1 Cognitive Action

In the world of AI-driven creativity, the lucataco/hunyuandit-v1.1 API offers powerful Cognitive Actions designed to transform text prompts into visually stunning images. One of its standout features is the ability to leverage advanced diffusion technology for generating images that are not only aesthetically pleasing but also deeply grounded in fine-grained Chinese language understanding. This opens exciting possibilities for applications in art, design, content creation, and more.

Prerequisites

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

  • API Key: You'll need an API key for the Cognitive Actions platform, which will allow you to authenticate your requests.
  • Basic Setup: Familiarity with making HTTP requests, as you will be sending JSON payloads to the Cognitive Actions endpoint.

For authentication, you will typically pass your API key in the request headers to access the service securely.

Cognitive Actions Overview

Transform Text to Image with Multi-Resolution Diffusion

This action employs Hunyuan-DiT, a sophisticated multi-resolution diffusion transformer, to generate images based on your text prompts. It supports bilingual text and utilizes advanced diffusion technologies for enhanced speed and quality.

Category: Text-to-Image

Input

The input for this action is structured as follows:

  • seed (integer, optional): A random seed for generating output. Leave blank for a random seed.
  • size (string, required): Specifies the output dimensions:
    • "square" (1024x1024)
    • "landscape" (768x1280)
    • "portrait" (1280x768)
    • Default is "square".
  • prompt (string, required): The main input text to generate the image. The default is "a cute cat".
  • sampler (string, optional): The algorithm used for sampling. Options include "ddpm", "ddim", or "dpmms". Default is "ddpm".
  • enhancePrompt (boolean, optional): Whether to enhance the input prompt for potentially improved output. Default is false.
  • guidanceScale (number, optional): Adjusts the strength of classifier-free guidance (1 to 20). Default is 6.
  • negativePrompt (string, optional): Elements to exclude from the output. Default is an empty string.
  • numInferenceSteps (integer, optional): Number of steps for denoising (1 to 500). Default is 40.

Example Input:

{
  "size": "square",
  "prompt": "A clever fox walks in a broadleaf forest next to a stream, realistic details, photography",
  "sampler": "ddpm",
  "enhancePrompt": false,
  "guidanceScale": 6,
  "negativePrompt": "",
  "numInferenceSteps": 20
}

Output

The action typically returns a URL pointing to the generated image.

Example Output:

https://assets.cognitiveactions.com/invocations/9e0b0118-d855-4b3b-bc43-66d9571ed40c/10f25528-bdc7-41c2-ba2c-a68cf0b97331.png

Conceptual Usage Example (Python)

Here's how you might structure a request to invoke this 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 = "42aed91c-07bc-48e2-8f48-79a0c15b727e" # Action ID for Transform Text to Image with Multi-Resolution Diffusion

# Construct the input payload based on the action's requirements
payload = {
    "size": "square",
    "prompt": "A clever fox walks in a broadleaf forest next to a stream, realistic details, photography",
    "sampler": "ddpm",
    "enhancePrompt": False,
    "guidanceScale": 6,
    "negativePrompt": "",
    "numInferenceSteps": 20
}

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 "Transform Text to Image with Multi-Resolution Diffusion" action. The input payload is structured according to the specifications outlined earlier.

Conclusion

The lucataco/hunyuandit-v1.1 Cognitive Actions provide a powerful solution for developers looking to integrate sophisticated text-to-image capabilities into their applications. By utilizing the robust Hunyuan-DiT model, you can create high-quality images from textual descriptions, opening up a world of creative possibilities. Consider exploring additional use cases, such as generating artwork, enhancing marketing materials, or even creating unique content for social media. Happy coding!

← Back to All Articles