API Reference
Chat Completion

Chat Completion

Generate immersive roleplay chat responses.

  • Endpoint: POST https://api.luvr.ai/v1/chat/completions

Request Body

FieldTypeRequiredDescription
chatArrayYesList of message objects {role, content}.
characterStringNoUsername of the character (e.g. "ember"). Loads personality.
max_tokensIntNoMax response length (Default: 550).
chatProfileObjectNoUser details {name, gender, personality} for context.

Example

{
  "chat": [
    {"role": "user", "content": "Hey, how are you?"}
  ],
  "character": "ember",
  "chatProfile": {
    "name": "Alex",
    "gender": "male"
  }
}

Response

{
  "content": "*She smiles warmly.* \"I'm doing great, Alex!\"",
  "cost_usd": 0.006,
  "timestamp": 1709823456
}