Creating a custom Persona

Before you can start integrating with the ojin/oris-portrait 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 image of the persona you want to animate (check Reference Image best practices for more details)

For best results, follow the reference image best practices below.

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-portrait 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 image. Make sure to follow the instructions below on how the image 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 Image best practices

• Image content:

  • Mouth should be closed, but smiles or subtle expressions are fine

  • The eyes should be looking directly into the camera

  • Keep the expression balanced — the image is used as the base for both the idle loop and speech, so avoid extreme poses

• Format: JPEG, PNG, or WebP

• Lighting: 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 →