Human API

Memory-enhanced endpoint that automatically injects user context to any LLM call.

Updated 27 December 2024
human-apillmopenaimemorypersonalization

What is Human API?

Human API is a memory-enhanced endpoint that automatically injects yours or Onairos user's context/memories that are relevant to any LLM call.

Human API is a key addition to Onairos's vision to make the personalised internet a reality.

Key Features

  • Compatible Interface: Use any OpenAI SDK — just change the base URL
  • Memory Injection: Add {onairos_memory} to prompts for instant personalization
  • Zero Infrastructure: No databases, embeddings, or RAG pipelines to manage
  • Privacy Built-in: Automatic PII removal and isolated user data

See How Apps Benefit From Using Onairos Memory

One base URL change. Personalized for every user, across any app. Click a scenario to compare responses.

Fewer Questions, Faster Onboarding

Real apps see up to 40% reduction in onboarding prompts across all major LLMs

GPT-4O
40%
(5 → 3)
Gemini 2.5
20%
(5 → 4)
Claude 4.5
18%
(11 → 9)
Other Dating Apps
19%
(16 → 13)

Dating app onboarding tests with personality traits and MBTI

Quick Example

// Standard OpenAI call
const response = await openai.chat.completions.create({
  model: 'gpt-4o',
  messages: [{
    role: 'user',
    content: 'What should I work out today?'
  }]
});
// Returns: Generic workout advice

// Just change these two lines in your existing code:
const onairos_client = new OpenAI({
  apiKey: 'your_app_api_key_here',           // Your developer key
  baseURL: 'https://developer.onairos.uk/v1' // Our endpoint
});

// Human API call with memory
const response = await onairos_client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{
    role: 'user',
    content: 'Based on {onairos_memory}, what should I work out today?'
  }]
});
// Returns: "Since you did legs yesterday and prefer morning cardio..."

Getting Started

1. Get Your API Keys

  • Sign up at developer.onairos.uk
  • Create an application (choose your type: fitness, dating, productivity, etc.)
  • Generate your API key from the dashboard
Key Types
  • Developer API key beginning with ona_
  • User authorized JWT key, after the user authorized Onairos data access via the in-app overlay

2. Update Your Code

import OpenAI from 'openai';

// Just change these two lines in your existing code:
const onairos_client = new OpenAI({
  apiKey: 'your_app_api_key_here',           // Your developer key
  baseURL: 'https://developer.onairos.uk/v1' // Our endpoint
});

// Add user identification from "Sign in with Onairos"
onairos_client.defaultHeaders = {
  'x-jwt-token': onairosUserJWT  // JWT token from user's Onairos auth
};

3. Add Memory to Prompts

// Before: Generic responses
'Help me plan my day'

// After: Personalized with memory
'Based on {onairos_memory}, help me plan my day'

// Onairos automatically injects relevant user context

Real-World Examples

Fitness App Integration

const response = await onairos_client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{
    role: 'user',
    content: 'Based on {onairos_memory}, what should I focus on in my workout today?'
  }]
});

Without memory: "Try a full-body workout with cardio and strength training..."

With memory: "Your progress shows you've been consistent with cardio. Since you did legs yesterday and prefer 30-minute sessions, let's focus on upper body strength training today."

Dating App Example

const response = await onairos_client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{
    role: 'user',
    content: 'Based on {onairos_memory}, suggest conversation starters for my matches'
  }]
});

Without memory: "Try asking about their hobbies, favorite movies, or travel experiences."

With memory: "Based on your interest in jazz music and weekend hiking, try asking about their favorite concert or outdoor adventures."

PreviousMobile ExamplesNextMemories API