Create Stunning Custom Emojis with Platmoji Beta Cognitive Actions

23 Apr 2025
Create Stunning Custom Emojis with Platmoji Beta Cognitive Actions

In the rapidly evolving world of digital communication, emojis have become a universal language. The appmeloncreator/platmoji-beta API provides developers with a powerful set of Cognitive Actions to create high-quality, custom emoji-style images. With advanced settings for image quality, aspect ratio, and fine-tuning options, you can generate unique emojis tailored to your application's needs. This guide will walk you through the capabilities of the Generate Custom Emojis with Flux action, allowing you to seamlessly integrate emoji generation into your projects.

Prerequisites

Before you can start using the Cognitive Actions, you need to ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and APIs.
  • Familiarity with making HTTP requests in your programming environment.

For authentication, you will pass your API key in the headers of your requests to authorize access.

Cognitive Actions Overview

Generate Custom Emojis with Flux

Description: This action recreates Apple's GenMoji emojis, allowing you to generate high-quality, custom emoji-style images. You can leverage advanced settings for image quality, aspect ratio, and LoRA adjustments to customize your results.

Category: Image Generation

Input

The input to this action requires a JSON object with the following schema:

{
  "prompt": "string (required)",
  "mask": "string (optional, uri)",
  "seed": "integer (optional)",
  "image": "string (optional, uri)",
  "width": "integer (optional, minimum: 256, maximum: 1440)",
  "goFast": "boolean (optional, default: false)",
  "height": "integer (optional, minimum: 256, maximum: 1440)",
  "outputFormat": "string (optional, default: 'webp', enum: ['webp', 'jpg', 'png'])",
  "numberOfOutputs": "integer (optional, default: 1, minimum: 1, maximum: 4)",
  "imageAspectRatio": "string (optional, default: '1:1', enum: ['1:1', '16:9', '21:9', '3:2', '2:3', '4:5', '5:4', '3:4', '4:3', '9:16', '9:21', 'custom'])",
  ...
}

Example Input:

{
  "width": 512,
  "goFast": false,
  "height": 512,
  "prompt": "An emoji of king cat. with a white background the head has to face the camera but the rest can stay. It has to be as high quality as possible. Every emoji you make has to be in the style of emojis. No grey human bodys, if you make people they have to have clothes eyes and hair and a shirt.",
  "loraScale": 0.5,
  "outputFormat": "png",
  "guidanceScale": 4.16,
  "outputQuality": 100,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "inferenceSteps": 50,
  "promptStrength": 1,
  "imageMegapixels": "1",
  "numberOfOutputs": 3,
  "imageAspectRatio": "1:1"
}

Output

The action typically returns an array of URLs pointing to the generated emoji images.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/5d5ddb13-6e9f-48cc-9912-5426954f2df1/a2874f77-3794-4c4b-adeb-ec95df5cffb7.png",
  "https://assets.cognitiveactions.com/invocations/5d5ddb13-6e9f-48cc-9912-5426954f2df1/a9576d5f-834f-4a8f-bb44-5af9d4004a13.png",
  "https://assets.cognitiveactions.com/invocations/5d5ddb13-6e9f-48cc-9912-5426954f2df1/31dd0d31-092c-46b6-aa67-4f42d17846c1.png"
]

Conceptual Usage Example (Python)

Here's a conceptual example of how you might call 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 = "e102a207-36d5-440a-8256-06a650849ffc"  # Action ID for Generate Custom Emojis with Flux

# Construct the input payload based on the action's requirements
payload = {
    "width": 512,
    "goFast": False,
    "height": 512,
    "prompt": "An emoji of king cat. with a white background the head has to face the camera but the rest can stay. It has to be as high quality as possible. Every emoji you make has to be in the style of emojis. No grey human bodys, if you make people they have to have clothes eyes and hair and a shirt.",
    "loraScale": 0.5,
    "outputFormat": "png",
    "guidanceScale": 4.16,
    "outputQuality": 100,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "inferenceSteps": 50,
    "promptStrength": 1,
    "imageMegapixels": "1",
    "numberOfOutputs": 3,
    "imageAspectRatio": "1:1"
}

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}")

This code snippet demonstrates how to structure your request to the Cognitive Actions API. Replace the COGNITIVE_ACTIONS_API_KEY and endpoint with your actual details. The action_id corresponds to the action you want to invoke, and the payload contains all necessary parameters for emoji generation.

Conclusion

The appmeloncreator/platmoji-beta Cognitive Actions provide a robust solution for generating custom emojis, enhancing user engagement in applications. With versatile options for input and output, developers can create unique emoji designs that fit their specific needs. Start integrating these actions today to bring your emoji creations to life!

← Back to All Articles