image-generation

Create Unique Loteria Cards with AI-Driven Image Generation

25 Apr 2025
Create Unique Loteria Cards with AI-Driven Image Generation

The Loteria Cognitive Actions API provides developers with a powerful tool for generating custom Loteria cards using advanced image generation techniques. By leveraging a fine-tuned version of the SDXL model, users can create unique card designs simply by inputting descriptive text prompts. This API not only speeds up the card creation process but also allows for a high level of customization, enabling developers to refine images and apply transformations to suit their needs.

Common use cases for the Loteria API include game development, educational materials, and personalized gifts. Imagine creating a unique set of Loteria cards for a family game night or designing educational tools that engage students through culturally relevant imagery. The possibilities are endless, making Loteria a versatile addition to any developer's toolkit.

Before diving in, ensure you have your Cognitive Actions API key and a general understanding of making API calls.

Generate Loteria Cards

The "Generate Loteria Cards" action allows users to create custom Loteria cards tailored to specific themes or concepts through descriptive prompts. This action addresses the need for unique and engaging card designs, enhancing creativity and personalization in various applications.

Input Requirements

The input schema for this action includes several parameters, such as:

  • Mask: A URI for the inpaint mode, where black areas are preserved, and white areas are inpainted.
  • Image: The URI of an input image for transformation in img2img or inpaint modes.
  • Width and Height: Dimensions of the output image, defaulting to 1024 pixels.
  • Prompt: Descriptive text guiding the image creation process.
  • Refine: The method to enhance the generated image.
  • Other parameters: Include seed, guidance strength, number of outputs, and more.

An example input could look like this:

{
  "mask": "https://replicate.delivery/pbxt/JKi5c4VtYANrvyqKm2uthgP3O5ieCdevhGgyHUcdawCalxrG/loteria-mask.jpg",
  "image": "https://replicate.delivery/pbxt/JKi5bg3gJ1l6v87rxL2xFGVco38v0PXU7BlL3EOVazn4G0u8/loteria-blank-card.jpg",
  "width": 1024,
  "height": 1024,
  "prompt": "A llama card in the style of TOK",
  "refine": "no_refiner",
  "loraScale": 0.6,
  "scheduler": "K_EULER",
  "applyWatermark": true,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "guidanceStrength": 7.5,
  "highNoiseFraction": 0.8,
  "numberOfInferenceSteps": 50
}

Expected Output

The expected output is a URI pointing to the generated Loteria card image. For instance:

"https://assets.cognitiveactions.com/invocations/e7f5fcdd-6e20-426b-a856-892ee010d49d/bf4bb07b-c55a-4948-a066-bdd790e7c579.png"

Use Cases for this Specific Action

This action is particularly useful for:

  • Game Development: Create visually appealing Loteria cards for traditional games or modern adaptations.
  • Educational Resources: Design custom cards that can be used in classrooms to teach cultural concepts and vocabulary.
  • Event Marketing: Generate themed cards for events, parties, or promotional materials that engage audiences in a fun way.

By utilizing the "Generate Loteria Cards" action, developers can enhance their projects with creative and visually engaging content.

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 = "b3e9c91e-eba0-4ca7-90e1-c4cdb4b2b58d" # Action ID for: Generate Loteria Cards

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "mask": "https://replicate.delivery/pbxt/JKi5c4VtYANrvyqKm2uthgP3O5ieCdevhGgyHUcdawCalxrG/loteria-mask.jpg",
  "image": "https://replicate.delivery/pbxt/JKi5bg3gJ1l6v87rxL2xFGVco38v0PXU7BlL3EOVazn4G0u8/loteria-blank-card.jpg",
  "width": 1024,
  "height": 1024,
  "prompt": "A llama card in the style of TOK",
  "refine": "no_refiner",
  "loraScale": 0.6,
  "scheduler": "K_EULER",
  "applyWatermark": true,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "guidanceStrength": 7.5,
  "highNoiseFraction": 0.8,
  "numberOfInferenceSteps": 50
}

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

The Loteria Cognitive Actions API offers developers an innovative way to create unique and customizable Loteria cards, streamlining the design process while enhancing creativity. With applications in game development, education, and marketing, this API is a valuable resource for any project requiring engaging imagery. As the next step, consider experimenting with different prompts and customization options to see how you can elevate your applications with bespoke Loteria designs.

← Back to All Articles