TuringMate API

Integrate AI characters into your applications with our REST API. Send messages, manage characters, and receive proactive messages via webhooks.

Quick Start

Get an API Key

Go to your Profile > API Keys and create a new key. Copy it somewhere safe — you won't see it again.

Buy Credits

Text messages cost 1 credit. Photo messages cost 2 credits. Purchase credit packages from your profile.

Send a Message

Make your first API call to chat with a character.

cURL

curl -X POST https://your-domain.com/api/v1/chat \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"characterId": "abc123", "message": "Hello!"}'

API Endpoints

POST

/api/v1/chat

Send a message and get an AI response (sync or async)

GET

/api/v1/characters

List available characters

POST

/api/v1/characters

Create a new character

GET

/api/v1/characters/:id

Get character details

PATCH

/api/v1/characters/:id

Update a character

DELETE

/api/v1/characters/:id

Delete a character

GET

/api/v1/conversations/:id

Get conversation history

GET

/api/v1/updates

Poll for async responses and proactive messages

Credits

Text messages (sent via UI or API) cost 1 credit. Photo messages cost 2 credits. Credits can be purchased in packages:

Package	Credits	Price	Per Text Message
Starter	100	$50	50¢
Growth	500	$175	35¢
Pro	1,000	$250	25¢

* Photo messages consume 2 credits each.