API Overview & Standards
AVAILABLEThe Naagmani API suite is split into two primary surfaces:
- Gateway Data Plane API (
:8080): Ultra-high-throughput, OpenAI-compatible AI inference proxy handling chat completions, embeddings, streaming SSE, and tool calling. - Control Plane Management API (
:8081): RESTful JSON API for managing Organizations, Projects, Service Tokens, Members, Budgets, and Telemetry.
Base URLs #
| Surface | Local Environment | Production Hosted |
|---|---|---|
| Gateway Data Plane | http://localhost:8080 | https://gateway.naagmani.app |
| Control Plane API | http://localhost:8081 | https://api.naagmani.app |
Standard Headers #
Every API request requires standard headers:
http
Authorization: Bearer <YOUR_API_KEY_OR_SERVICE_TOKEN>
Content-Type: application/json
X-Request-ID: req_01J8F0A2B3C4D5E6F7G8H9J0K1 (Optional client tracing ID)Next Steps #
- Authentication details: Authentication & Headers
- Chat completions spec: Chat Completions API