AINative API Discovery
AINative exposes 89+ REST API endpoints at https://api.ainative.studio.
Endpoint Categories
Authentication & Users
| Endpoint |
Method |
Description |
/api/v1/auth/login |
POST |
Email/password login → JWT |
/api/v1/auth/register |
POST |
Create account |
/api/v1/auth/refresh |
POST |
Refresh JWT token |
/api/v1/auth/logout |
POST |
Invalidate session |
/api/v1/users/me |
GET |
Get current user profile |
Chat & AI Completions
| Endpoint |
Method |
Description |
/v1/public/chat/completions |
POST |
Chat completion (streaming + non-streaming) |
/api/v1/public/managed-chat |
POST |
Managed chat with session tracking |
/api/v1/public/models |
GET |
List available AI models |
Memory (ZeroMemory)
| Endpoint |
Method |
Description |
/api/v1/public/memory/v2/remember |
POST |
Store a memory |
/api/v1/public/memory/v2/recall |
POST |
Semantic search memories |
/api/v1/public/memory/v2/forget |
DELETE |
Remove memories |
/api/v1/public/memory/v2/reflect |
GET |
Get memory insights |
/api/v1/public/memory/v2/profile |
GET |
Build user profile from memories |
/api/v1/public/memory/v2/graph |
GET |
Memory knowledge graph |
Credits & Billing
| Endpoint |
Method |
Description |
/api/v1/public/credits/balance |
GET |
Get current credit balance |
/api/v1/public/credits/usage |
GET |
Credit usage history |
/api/v1/billing/subscribe |
POST |
Subscribe to a plan |
/api/v1/billing/invoices |
GET |
List invoices |
Developer Program (Echo)
| Endpoint |
Method |
Description |
/api/v1/echo/register |
POST |
Register as a developer |
/api/v1/echo/earnings |
GET |
Get earnings summary |
/api/v1/echo/payouts |
GET |
List payouts |
/api/v1/echo/markup |
PUT |
Set your markup rate (0-40%) |
ZeroDB (Vector/NoSQL/Storage)
| Endpoint |
Method |
Description |
/api/v1/public/zerodb/vectors/upsert |
POST |
Upsert vector embedding |
/api/v1/public/zerodb/vectors/search |
POST |
Semantic vector search |
/api/v1/public/zerodb/tables |
GET/POST |
List/create NoSQL tables |
/api/v1/public/zerodb/files/upload |
POST |
Upload file |
Admin & Monitoring
| Endpoint |
Method |
Description |
/admin/users |
GET |
List all users (superuser) |
/admin/monitoring |
GET |
System health metrics |
/admin/database |
GET |
Database pool status |
/health |
GET |
Health check (no auth) |
Authentication
All public endpoints require an API key:
# Header format
X-API-Key: ak_your_key_here
# Or Bearer token (for user sessions)
Authorization: Bearer eyJ...
Code Examples
Python
import requests
API_KEY = "ak_your_key"
BASE = "https://api.ainative.studio"
# Chat completion
resp = requests.post(f"{BASE}/v1/public/chat/completions",
headers={"X-API-Key": API_KEY},
json={"model": "claude-3-5-sonnet-20241022",
"messages": [{"role": "user", "content": "Hello"}]}
)
print(resp.json()["choices"][0]["message"]["content"])
# Credit balance
balance = requests.get(f"{BASE}/api/v1/public/credits/balance",
headers={"X-API-Key": API_KEY}).json()
print(f"Credits: {balance['remaining_credits']}")
JavaScript/TypeScript
const API_KEY = "ak_your_key";
const BASE = "https://api.ainative.studio";
const resp = await fetch(`${BASE}/v1/public/chat/completions`, {
method: "POST",
headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
model: "claude-3-5-sonnet-20241022",
messages: [{ role: "user", content: "Hello" }]
})
});
const data = await resp.json();
curl
curl -X POST https://api.ainative.studio/v1/public/chat/completions \
-H "X-API-Key: ak_your_key" \
-H "Content-Type: application/json" \
-d '{"model":"claude-3-5-sonnet-20241022","messages":[{"role":"user","content":"Hello"}]}'
References
docs/api/API_REFERENCE.md — Complete endpoint documentationdocs/api/API_ENDPOINTS_REFERENCE.md — Full endpoint indexsrc/backend/app/api/v1/endpoints/ — Implementation source
luokai0