Summonr - AI Companion Chat API
Create AI companions with custom personalities and have real-time group conversations with them in fantasy rooms. Multi-agent streaming chat API. I'm using Gemini serious, NSFW is available to some extend
Summonr - AI Companion Chat API endpoints
| Method | Endpoint | Description |
|---|---|---|
| health | ||
| GET |
healthCheck /health |
Check that the API is reachable. No authentication required. |
| users | ||
| POST |
listUsers /users/list |
List all users belonging to your subscriber account, with pagination. |
| POST |
createUser /users/create |
Create a new user account with email and nickname. No password required. |
| companions | ||
| POST |
getCompanionDetail /companions/detail |
Get full details for a specific companion. |
| POST |
listCompanions /companions/list |
List all companions for a user, with pagination. Returns full companion details. |
| POST |
deleteCompanion /companions/delete |
Delete a companion. The companion will no longer be available for use in rooms. |
| POST |
createCompanion /companions/create |
Create an AI companion with a custom personality, character profile, and intelligence level. The companion can then be added to rooms to participate in conversations.… |
| rooms | ||
| POST |
listRoomCompanions /rooms/companions/list |
List all companions currently in a room with their mute status. No pagination (rooms have a limited number of companions). |
| POST |
createRoom /rooms/create |
Create a chat room. Optionally set a host nickname (your character name), a host character profile, and a worldview that all companions will respect during conversation. |
| POST |
streamMessages /rooms/messages/stream |
Send a message to a room and receive AI companion responses as a real-time NDJSON stream. Each companion in the room responds in sequence with full context awareness. **Stream… |
| POST |
removeCompanionsFromRoom /rooms/companions/remove |
Remove one or more companions from a room. The companions themselves are not deleted. |
| POST |
addCompanionsToRoom /rooms/companions/add |
Add one or more companions to a room. Companions must exist and be active. There is a maximum number of companions per room. |
| POST |
listRooms /rooms/list |
List all rooms for a user, with pagination. Returns full room details. |
| POST |
getRoomDetail /rooms/detail |
Get full details for a specific room, including host nickname, character profile, and worldview. |
| POST |
muteCompanionInRoom /rooms/companions/mute |
Mute a companion so it stops responding in a room. The companion remains in the room but will be skipped during conversation rounds. |
| Other endpoints | ||
| POST |
createCompanion /companions/create |
Create an AI companion with a custom personality, character profile, and intelligence level. The companion can then be added to rooms to participate in conversations.… |
| POST |
deleteCompanion /companions/delete |
Delete a companion. The companion will no longer be available for use in rooms. |
| POST |
createUser /users/create |
Create a new user account with email and nickname. No password required. |
| POST |
removeCompanionsFromRoom /rooms/companions/remove |
Remove one or more companions from a room. The companions themselves are not deleted. |
| POST |
addCompanionsToRoom /rooms/companions/add |
Add one or more companions to a room. Companions must exist and be active. There is a maximum number of companions per room. |
| POST |
createRoom /rooms/create |
Create a chat room. Optionally set a host nickname (your character name), a host character profile, and a worldview that all companions will respect during conversation. |
| POST |
muteCompanionInRoom /rooms/companions/mute |
Mute a companion so it stops responding in a room. The companion remains in the room but will be skipped during conversation rounds. |
| POST |
streamMessages /rooms/messages/stream |
Send a message to a room and receive AI companion responses as a real-time NDJSON stream. Each companion in the room responds in sequence with full context awareness. **Stream… |
Summonr - AI Companion Chat API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 100 / minute |
|
| PRO | $20 / month | 1000 / second |
|