ManyMe API Documentation

Overview

The ManyMe API allows developers to interact with ManyMe personas through endpoints for server health checks, persona generation, and persona search.

Join the API Waitlist

Sign up to get early private beta access to the ManyMe API

Base URL

http://localhost:5588

Endpoints

GET /api/v1/health

Returns the health status of the ManyMe Personas v1 API.

Example Request:

GET http://localhost:5588/api/v1/health

Response:

Status: 200 OK

Content-Type: text/html

/api/v1/health Alive

GET /api/v1/gen-persona

Generates a new persona object with default or random values.

Example Request:

GET http://localhost:5588/api/v1/gen-persona

Response:

Status: 200 OK

Content-Type: application/json

{
  "newPersona": {
    "id": "",
    "personaProfile": {
      "personaName": "",
      "description": "",
      "hotWords": [""]
    },
    "personaSelfie": ""
  }
}

POST /api/v1/search-persona

Searches for a persona based on given criteria.

Request Body:

{
  "searchPersona": "expert chef on taiwan food"
}

Example Request:

POST http://localhost:5588/api/v1/search-persona

Response:

Status: 200 OK

Content-Type: application/json

{
  "generatedFoundPersona": {
    "id": "",
    "personaProfile": {
      "personaName": "",
      "description": "",
      "hotWords": [""]
    },
    "personaSelfie": ""
  }
}

POST /api/v1/queue/chat/request

Sends a chat message to the queue for processing.

Request Body:

{
  "input": "Hello, how are you?",
  "messages": "",
  "persona": "GeminiGPT",
  "personaTransform": false
}

Request Parameters:

  • input (string): The input message for the chat request
  • messages (string): String for messages meta data from previous chat response. Empty if first request
  • persona (string): The persona for the chat request
  • personaTransform (boolean): Indicates whether to transform any text or 3rd-party LLM responses into the style and essence of the defined persona.

Example Request:

POST http://localhost:5588/api/v1/queue/chat/request

Response:

Status: 200 OK

Content-Type: application/json

{
  "message": "",
  "messageId": ""
}

POST /api/v1/queue/chat/response

Retrieves a chat response from the queue using a message ID.

Request Body:

{
  "messageId": "808079fd-f3db-40a0-95a0-52dc9e664852"
}

Request Parameters:

  • messageId (string): A unique identifier for the chat message

Example Request:

POST http://localhost:5588/api/v1/queue/chat/response

Response:

Status: 200 OK

Content-Type: application/json

{
  "reply": "",
  "messages": "",
  "error": ""
}