OnlyWhales — The Emotional Engine for Global Platforms

Core Capabilities

Four engines. One integration.

Years at the frontier of social, entertainment & companionship AI — distilled into four production-ready APIs.

Persona Engine

Autonomous Persona Engine

Input a few lines of character definition. Get a fully autonomous companion with distinct voice, persistent memory, and natural emotional range — no prompt engineering required.

Custom persona live in <5 minutes

Monetization

Contextual Monetization Trigger

The AI knows when to sell. It reads emotional context in real-time and surfaces payment hooks — unlocked content, gifts, subscriptions — without ever breaking the user's immersion.

Avg. CVR uplift +38%

Adaptive Learning

Adaptive Reinforcement Engine

Every conversation makes the AI sharper. Continuous stream learning means the longer a user engages, the more addictive the experience — and the higher your LTV compounds.

ARPU compounds 3.2× by Day 30

Infrastructure

Enterprise AI Safety & Compliance

Multi-layer safety framework covering hallucination prevention, character consistency enforcement, and automatic filtering of illegal or policy-violating content. GDPR-compliant data isolation with zero cross-tenant leakage — so your platform stays safe, coherent, and audit-ready.

99.9% uptime SLA

Use Cases

Built for your platform.

Whether you're building the next social phenomenon or scaling a creator economy, OnlyWhales fits right in.

Social & Companion Apps

Companions that remember every conversation and grow more engaging with each session. Natural 7-day retention lift.

↑ 7-day retention +52% avg.

Games & Virtual Worlds

NPCs with persistent memory and real emotional responses. Characters that drive in-game purchases without feeling like ads.

↑ In-game purchase rate +41%

Virtual Creators & Vtubers

24/7 always-on digital personas that never fatigue. Each fan interaction is personalized, remembered, and naturally monetized.

↑ Fan LTV +280% in 90 days

Creator Economy

Let creators scale 1:1 interactions infinitely with AI that truly sounds like them — driving subscriptions, tips, and exclusive content sales.

↑ Creator ARPU +3.2×

Entertainment & Media

Interactive narrative experiences where the story adapts to each user. Characters that build real emotional bonds with your audience.

↑ Session length +87%

Need a Custom Solution?

Unique use case? We offer white-glove integration, private deployment, and fully custom AI persona development for enterprise partners.

→ Talk to our team

Docs · Quick Start

One endpoint. Five-minute integration.

Plug your character agent in with a single POST request. No SDK required, no boilerplate — just send a message and stream the reply.

POST https://api.onlywhales.ai/api/v1/chat

Headers

Authorization string REQUIRED

Bearer token issued from your portal dashboard. Format: Bearer sk_...

Body

request_id string REQUIRED

Unique ID of the downstream request — echoed back as-is in the response for tracing.

role_id string REQUIRED

Stable identifier for the character, for conversation tracking and memory storage.

role_profile string REQUIRED

The character persona — fully user-configurable, editable at any time. The underlying agent's voice, content, and conversational boundaries all shift with this profile, so your users can fine-tune their character on the fly.

user_id string REQUIRED

Stable identifier for the end user, for conversation tracking and and memory storage.

chat_history ChatMessage[] REQUIRED

Recent conversation history. The longer the better. Each ChatMessage has role ("user" | "assistant"), content (messages sent that turn) and actions — only for custom plans.

role_name string

The Name of your character. Strongly recommended if you don't specify role name in role profile.

session_id string

Use session ID you want to manage the conversation memory by session, otherwise leave it blank.

user_profile string

portrait of user, contains public information from your platform. — e.g. name, location, age.

request.sh

# Plug your character agent in with a single POST.
curl -X POST "https://api.onlywhales.ai/api/v1/chat" \
  -H "Authorization: Bearer sk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "req_8f21",
    "role_id": "agent_001",
    "role_name": "Sherry",
    "role_profile": "1. Bartender in Tokyo. 2. Loves vinyl & late-night ramen; avoids small talk about politics & finance & technology related topics.",
    "user_id": "user_001",
    "user_profile": "Alex, San Francisco, 27.",
    "chat_history": [
      {
        "role": "user",
        "content": ["u still up?"]
      }
    ]
  }'

import requests

payload = {
    "request_id": "req_8f21",
    "role_id": "sherry",
    "role_name": "Sherry",
    "role_profile": "1. Bartender in Tokyo. 2. Loves vinyl & late-night ramen; avoids small talk about office politics.",
    "user_id": "u_001",
    "user_profile": "Alex, San Francisco, 27.",
    "chat_history": [
        {
            "role": "user",
            "content": ["u still up?"]
        },
    ],
}

res = requests.post(
    "https://api.onlywhales.ai/api/v1/chat",
    headers={"Authorization": "Bearer sk_xxxxxxxx"},
    json=payload,
)
print(res.json())

{
  "request_id": "req_8f21",
  "role_id": "sherry",
  "user_id": "u_001",
  "messages": [
    "yeah, still here 👀",
    "what's keeping you up tonight?"
  ],
  // extra_instructions: custom user-defined platform operation instructions
  "extra_instructions": {
    # NOTIFY the conversation has not end, you can invoke again
    "NOTIFY-allow_next_request"
  }
}

200 OK

Pricing

Pay for what you use.

Start free, scale as you grow. No monthly minimums, no hidden fees, no surprises.

Free

$0

1M tokens · one-time trial

✓Basic Persona Engine
✓Stateless Agent Service
✓REST API + Python & Node SDK
✓Community support

Get API Key

Turn conversations
into compounding
revenue.

Four engines. One integration.

Built for your platform.

One endpoint. Five-minute integration.

Pay for what you use.

Your competitors are already
building with emotional AI.

Turn conversations into compounding revenue.

Four engines. One integration.

Built for your platform.

One endpoint. Five-minute integration.

Pay for what you use.

Your competitors are already building with emotional AI.

Turn conversations
into compounding
revenue.

Your competitors are already
building with emotional AI.