Skip to main content
The Humalike API is a set of HTTP APIs for building agents that behave like people in conversation — learning how a group talks, deciding when to speak, pacing replies, remembering who said what, and reading how a message will land. Every API shares one base URL, one bearer-token authentication scheme, one error envelope, and one credit balance. Learn those once on this page, then go to the API you need.

​
Base URL

All requests go to:
Every request must be made over HTTPS. Plain HTTP is not supported.

​
The APIs

Persona API

Generate a grounded, lifelike population from a single prompt.

Social Learning API

Turn a chat transcript into a profile of how a group talks, plus a ready-to-use prompt block.

Social Observability API

Turn a transcript into an evidence-cited reception report for one of your agents.

Social Memory API

Person-centric memory of a group conversation — ingest, recall, and ask.

Theory of Mind API

Predict how a reply will land and get a refined version before you send it.

Turn-taking API

Decide when an agent should speak and pace its reply like a real person.

​
Start here

Quickstart

Make your first authenticated request in a couple of minutes.

Authentication

Send your bearer token on every request.

Credits and billing

How billable calls are metered, and the 402 you get when your balance is low.

Errors

The status codes and error envelope shared across every API.

​
Conventions

These hold across every Humalike API:
  • Requests and responses are JSON (Content-Type: application/json).
  • Authentication uses the Authorization: Bearer <token> header on every request. See Authentication.
  • Successful responses use 2xx status codes; failures use 4xx/5xx with a consistent error envelope.
  • Billable calls draw down a shared credit balance and return 402 when it can’t cover the request. See Credits and billing.