Kinetix Documentation
Website
  • 🖐️Welcome
  • 🕺About Kinetix
  • 🖌️User-Generated Emote
    • 🤖Video-to-animation AI
    • 🤸Kinetix Emote Standards
    • 🦴Retargeting
    • 🏂Kinanim (Emote streaming)
    • 🖊️Try the User-Generated Emote feature
  • INTEGRATION
    • 🤷SDK or API: what to choose
    • 🤩Kinetix SDK
      • ⚙️SDK - Core Package
      • 🧩SDK - Sample scene
      • 🧑‍💻Tested & approved Game Engines for the SDK
      • 💻SDK Integration in Unity
        • ⬇️Set-up Unity & Import the SDK
          • 🔑Get your Game authentification API Key
          • ⚙️Setup your Unity environment
          • 🔧Install the Kinetix SDK in Unity
          • ⌨️SDK Initialization - Unity
        • ⚡Quickstart - Unity SDK
        • 🦋SDK Core Modules activation - Unity
          • 🔐Account Management in Unity
          • 💃Animation System - Unity
            • 🎢Unity's Animator System
            • 🎨Custom Animation System
            • 🌳Root Motion
              • RootMotion + NavMeshAgent
            • 🎞️Frame Controller
            • 💪IK Controller
            • 🫥Avatar Mask
          • 📶Network - Unity SDK
            • Photon PUN
            • Photon Fusion
        • 🕺User-Generated Emote integration (Unity)
          • Embedding the PWA in your Unity application
          • Validation / Retake
        • 🚧How to update Kinetix SDK in Unity?
        • 📕SDK API Reference - Unity
          • KinetixCore
          • KinetixCore.Account
          • KinetixCore.Animation
          • KinetixCore.Metadata
          • KinetixCore.Network
          • KinetixCore.UGC
        • 📂Unity SDK Changelog
      • 🕹️SDK Integration in Unreal Engine
        • ⬇️Set-up Unreal Engine & Download the SDK
          • 🔑Get your Game authentification API Key
          • ⚙️Set up your Unreal Engine environment
          • 🔧Install the Kinetix SDK in Unreal
          • ⌨️UE SDK Core Package Initialization
        • ⚡Quick Start
        • 🦋SDK Core Modules activation - Unreal
          • 🔐Account Management - UE
          • 💃Animation System - UE
            • Local player system in Unreal Engine
            • Avatar system in Unreal Engine
            • Without uploading an avatar (deprecated)
              • Animation in a Third Person Template
              • Animation in an existing project
          • 📶Network - UE SDK
        • 🕺User-Generated Emote integration (UE)
        • 📕SDK API Reference - UE
          • KinetixCore
          • KinetixCore.Account
          • KinetixCore.Animation
          • KinetixCore.Metadata
          • KinetixCore.Network
        • ⬆️Updating from 0.3 to 0.4
        • 📂UE SDK Changelog
    • 😍Kinetix API
      • 🔑Get your Authentification API key
      • 🔌API routes
      • 🪝API Webhooks
      • 🏓Possible Return Codes
  • Management
    • 🚪Developer Portal
      • 👽Avatar Upload
      • 👮UGC Moderation
    • 🖌️UGE: Guides & Best Practices
      • 📐User-Generated Emote specifications
      • 👌Video recording best practices
      • 👻User-Generate Emote Use Cases
  • SUPPORT
    • 📬Bugs reports & features requests
    • ❓FAQ
      • FAQ: General questions
      • FAQ: Unity SDK
      • FAQ: Unreal Engine SDK
    • 🤕Troubleshooting
    • 📚Glossary of terms
Powered by GitBook
On this page
  • Creating an emote creation feature in your game or app, with the Kinetix API
  • 1. Identify your users / players (clients)
  • 2. Create a token for each emote creation process
  • 3. QR Code Generation and Video Submission
  • 4. Creating the custom emote
  • 5. Process Status and Validation
  • 6. Retake option
  • 7. Integration in your game
  • Get started with the User-Generated Emote feature, integrating the Kinetix API
  • STEP 1: Retrieve your game authentification API key
  • STEP 2: Explore the API routes
  • STEP 3: Integrate Webhooks
  • STEP 4: Learn about the possible return codes of our API

Was this helpful?

Export as PDF
  1. INTEGRATION

Kinetix API

Integrate Kinetix's API and get started with the User-Generated Emote feature!

PreviousUE SDK ChangelogNextGet your Authentification API key

Last updated 10 months ago

Was this helpful?

The raw swagger documentation API can be found there :

Welcome to the Kinetix API, a solution designed to integrate the User-Generated Emote feature in any game or app, empowering players to create custom emotes from videos through a seamless and interactive process. This API enables game studios to fully customize the integration of the feature in their game or app.

Make sure you know all about the User-Generated Emote feature before moving on.


Creating an emote creation feature in your game or app, with the Kinetix API

When using the Kinetix API to bring the User-Generated Emote feature in your game, you need to recreate the main steps of the emote creation flow we've designed.

1. Identify your users / players (clients)

Before integrating the Kinetix API into your game, establishing a secure method for authenticating and identifying your users is paramount. Our system leverages OAuth 2.0, a robust protocol designed to ensure that user interactions with Kinetix's AI are securely authenticated. Without the authentication step, it is impossible to associate players with generated emotes.

Authentication ensures that emotes generated through the Kinetix AI are uniquely associated with the correct user account, enabling a personalized gaming experience.

You can find all the API routes corresponding to the authentication step in

2. Create a token for each emote creation process

Once authenticated, your game will request a token from Kinetix’s API. This token is crucial for initiating the Machine Learning (ML) process that transforms player-submitted videos into custom emotes. It acts as a temporary credential, that allow your game and the Kinetix API to identify and authorize users without directly handling their login credentials. Tokens ensure that each request to the API is authenticated and authorized, enabling a secure and personalized user experience.

3. QR Code Generation and Video Submission

With the token generated, the next step is to create a QR code that players can scan. This QR code directs players to a secure upload interface where they can submit their video. This step emphasizes user-friendliness, allowing players to easily contribute content from their devices.

4. Creating the custom emote

After video submission, your game uses the API to initiate the ML process, sending the video along with the token to Kinetix’s servers. Our advanced AI analyzes the video, crafting a custom animation that captures the player’s intended emote.

5. Process Status and Validation

Throughout the ML process, your game can query the API to check the status of the emote creation. Once complete, you'll validate the process, making the emote available in-game. This step ensures that the generated content meets quality standards and is ready for use.

6. Retake option

If necessary, players can retake or adjust their submissions to ensure the final emote perfectly captures their vision. This flexibility enhances user satisfaction by providing options to refine the content. Of course, this part of the feature is totally optional.

7. Integration in your game

Finally, the Kinetix API delivers the user-generated emote, in formats like FBX or GLB, ready to be integrated into your game, allowing the player to use it with their avatar.


Get started with the User-Generated Emote feature, integrating the Kinetix API

Ready to integrate the User-Generated Emote feature with the Kinetix API? Follow the steps below!

STEP 1: Retrieve your game authentification API key

STEP 2: Explore the API routes

STEP 3: Integrate Webhooks

STEP 4: Learn about the possible return codes of our API

Have troubles integrating Kinetix API? We're here to help you!

To receive emotes crafted on your players' avatars, you need to upload your game's avatar on the . Learn more: Avatar Upload

Please send a kind , we will be happy to support you.

😍
Kinetix Developer Portal
🔑Get your Authentification API key
🔌API routes
🪝API Webhooks
🏓Possible Return Codes
email to Ben
https://sdk-api.kinetix.tech/documentation/#/
Login Routes