Developer Documentation

Mirakai API Reference

Integrate intelligent AI characters into your game, app, or website using our simple REST API.

Get Your API Key

Authentication

All API requests require a Bearer Token. You can generate your secret key in the Dashboard.

Authorization: Bearer YOUR_API_KEY

Chat Endpoint

POST/api/v1/chat

Sends a user message to a specific character and receives an AI response. Includes context awareness if a sessionId is provided.

Request Body

  • characterIdReq
    string

    The unique ID of the AI character (found in URL).

  • messageReq
    string

    The user's input text.

  • sessionId
    string

    (Optional) ID to continue an existing conversation.

# Python Example
import requests

BASE_URL = "https://chatmirakai.com"
API_KEY = "YOUR_API_KEY"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

def send_message(character_id, message, session_id=None):
    payload = {
        "characterId": character_id,
        "message": message,
    }
    if session_id:
        payload["sessionId"] = session_id

    res = requests.post(f"{BASE_URL}/api/v1/chat", json=payload, headers=headers)
    res.raise_for_status()
    return res.json()

# Start conversation
resp1 = send_message("char-123", "Hello!")
print("AI:", resp1["message"])