Creating a custom Persona

Before you can start integrating with the ojin/oris model, you'll need to create a persona configuration. This guide walks you through the process of creating a persona that looks exactly how you want.

Prerequisites

  • An Ojin account with an active API key

  • A high-quality reference video of the persona you want to animate (check Reference Video best practices for more details)

For best results, follow reference video best practices next

Creating a Persona configuration through the Dashboard

The simplest way to create a persona is through the Ojin Dashboard:

  1. Log in to the Ojin Dashboard

  2. Select the ojin/oris-1.0 model

  3. Navigate to Configs sub-section

  4. Press New Configuration button to create a new configuration

  5. Fill in required fields and upload a reference video. Make sure to follow the instructions bellow on how the video should look.

  6. Click Create Configuration

  7. Open your newly created configuration and copy Model Config ID parameter which will be used by your application

Reference Video best practices

  • Video content:

    • The video will be used as base for your persona idle loop and speech. Make sure to make the movements of the person balanced, not too expressive, not too still. so that it fits both states

    • Mouth should be closed during the entire video, but smiles or gestures are not a problem

    • The eyes should be looking directly into the camera.

    • Minimum length of video for better results recommended is 15 seconds

    • The length of the video should not be more than 30 seconds.

  • Resolution: Use 1080p resolution for the reference video and at least 25 fps

  • Lighting: Ensure even lighting with no harsh shadows

  • Face Position: The face should be clearly visible and centered

  • Background: Simple backgrounds work best

  • Accessories: Avoid sunglasses or items that obscure facial features

Next Steps

Once your persona is ready, you can:

Integration Guide

Learn how to integrate your persona using Pipecat or WebSocket

View Integration Guide →

API Reference

Explore the complete API documentation

View API Reference →

Last updated

Was this helpful?