image-generation

Create Stunning Images with Xtina's Advanced Image Generation

27 Apr 2025
Create Stunning Images with Xtina's Advanced Image Generation

In the world of digital creativity, the ability to generate unique images on demand can dramatically enhance workflows for developers and artists alike. Xtina offers powerful Cognitive Actions that allow you to generate images using customizable parameters, ensuring a tailored experience for your specific needs. With capabilities to adjust resolution, aspect ratio, and various model types, Xtina empowers developers to create stunning visuals efficiently. Common use cases include generating artwork for games, creating marketing materials, and producing personalized graphics for social media campaigns.

Prerequisites

To get started with Xtina's image generation capabilities, you will need an API key for the Cognitive Actions service and a basic understanding of making API calls.

Generate Image Using XTINA

The "Generate Image Using XTINA" action is designed to create images based on a text prompt, leveraging the advanced capabilities of the XTINA model. This action solves the challenge of generating high-quality visuals quickly and efficiently, allowing for customization in aspects like image resolution, LoRA intensity, and output format.

Input Requirements

To use this action, you need to provide a prompt, which serves as the creative briefing for the image. Additional parameters can include:

  • mask: A URI for an image mask when inpainting.
  • seed: An integer to ensure reproducibility.
  • image: A URI for input images, applicable in image-to-image transformations.
  • width and height: Dimensions for the generated image when using a custom aspect ratio.
  • goFast: A boolean to enable a speed-optimized model.
  • numOutputs: The number of images to generate (between 1 and 4).

Expected Output

The expected output is a URL link to the generated image. Depending on the parameters, the image will be produced in the specified format (webp, jpg, or png), with the quality and characteristics determined by your chosen settings.

Use Cases for this Specific Action

This action is ideal for developers looking to automate the creation of custom images for various applications. Some specific scenarios include:

  • Game Development: Generate character designs or backgrounds on the fly, enhancing the creative process without the need for manual illustration.
  • Marketing and Advertising: Create unique visuals for campaigns, allowing for quick iterations based on changing themes or brand needs.
  • Personalized Content: Use the action to generate tailored graphics for users, enhancing engagement on platforms such as social media or websites.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "717f26a6-126c-4898-b6a0-cbc965212280" # Action ID for: Generate Image Using XTINA

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "goFast": false,
  "prompt": "XTINA as an etherial fairy with translucent wings",
  "loraScale": 1,
  "modelType": "dev",
  "numOutputs": 1,
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

Xtina's image generation capabilities offer developers a powerful tool for creating high-quality, customized visuals efficiently. By leveraging the flexibility of parameters and the speed of the service, developers can meet diverse creative needs, from game design to marketing materials. As you explore these actions, consider integrating them into your projects to unlock new creative possibilities and streamline your workflows. The next step could involve experimenting with different prompts and settings to see how Xtina can best serve your specific image generation needs.

← Back to All Articles