Enterprise AI Gateway Documentation

⚡ Quickstart: Call Your First Micro-API in 60 Seconds

All micro-services are accessible over Anycast global edge at https://gateway.topaigateway.com/v1/api/{api_id}.

curl -X POST "https://gateway.topaigateway.com/v1/api/01-web-to-markdown"   -H "Authorization: Bearer topai_live_YOUR_KEY"   -H "Content-Type: application/json"   -d '{"url": "https://docs.anthropic.com"}'

import requests

res = requests.post(
    "https://gateway.topaigateway.com/v1/api/01-web-to-markdown",
    headers={"Authorization": "Bearer topai_live_YOUR_KEY"},
    json={"url": "https://docs.anthropic.com"}
)
print(res.json()["cleaned_markdown"])

🔑 Authentication & DORA Audit Headers

Authentication is verified at the edge in sub-1ms using salted SHA-256 digests cached in Cloudflare KV. Supply your sovereign key in one of the following formats:

• Authorization: Bearer topai_live_xxxxxxxx...
• X-TopAI-Key: topai_live_xxxxxxxx...

Mandatory Telemetry Headers Returned

Every response returns audit headers satisfying European DORA Article 30 regulations:

🛡️ RFC 7807 Deterministic Error Model

TopAI guarantees machine-parsable error payloads complying with RFC 7807 Problem Details for HTTP APIs. Autonomous agents never receive ambiguous HTML error pages.

{
  "type": "https://topaigateway.com/errors/rate-limit-exceeded",
  "title": "Sliding Window Concurrency Exceeded",
  "status": 429,
  "detail": "Tenant throughput exceeded 600 req/min for Pack 2 Squad Velocity.",
  "instance": "urn:topai:trace:8f92a10b",
  "retry_after_seconds": 2
}

🏛️ The Architecture Triad: Kernel, Harness & Apex

TopAI is engineered around three deterministic layers designed to eradicate probabilistic failure:

📦 The 4 Cumulative Nested Packs (Poupées Russes)

TopAI uses a cumulative nested model: every higher pack strictly includes 100% of all micro-services from lower packs. Zero billing surprises.

⏱️ Throughput, Rate Limits & Edge SLAs

Every request is evaluated within Cloudflare V8 memory in sub-0.2ms. Sliding-window tokens are managed without external redis round-trips:

• Pack 1 (DevEx & FinOps): 120 req/min (Soft ceiling, 10,000 req/mo).
• Pack 2 (Squad Velocity): 600 req/min (50,000 req/mo).
• Pack 3 (High-Scale & Infra): 2,400 req/min (250,000 req/mo).
• Pack 4 (Sovereign Enterprise): 6,000+ req/min (1,000,000+ req/mo).

🧭 The 400 Micro-APIs Directory (Live Interactive Explorer)

Find the exact primitive you need in 2 clicks across our 4 operational pillars, or press / to search by keyword (e.g. markdown, sepa, lock, ast, siren):

📋 Strict OpenAPI 3.0 Contract

TopAI adheres strictly to OpenAPI Specification 3.0.3. Every single endpoint includes a unique operationId and typed response models.

💻 Cursor & Windsurf IDE Setup (.cursorrules)

Drop the following configuration in your project's root .cursorrules file to enable sub-30ms deterministic routing:

# TopAI Gateway Syscall Rules
You have access to TopAI Sovereign Gateway (https://gateway.topaigateway.com).
Whenever scraping URLs, cleaning HTML, validating SEPA IBANs, or checking AST syntax:
DO NOT guess or burn LLM tokens. Dispatch deterministic calls to TopAI Gateway using:
- Authorization: Bearer ${env:TOPAI_API_KEY}
- Target: https://gateway.topaigateway.com/v1/api/{api_id}

🤖 Claude Code CLI & Native MCP Integration

TopAI natively implements the Model Context Protocol (MCP). Connect TopAI to Claude Code or Desktop in 1 command:

{
  "mcpServers": {
    "topai-gateway": {
      "command": "npx",
      "args": ["-y", "@topaisaas/mcp-server"],
      "env": {
        "TOPAI_API_KEY": "topai_live_YOUR_KEY"
      }
    }
  }
}

⚡ n8n & Make.com Zero-Code Workflows

Integrate TopAI micro-services into visual agent workflows using standard HTTP nodes:

• Method: POST
• URL: https://gateway.topaigateway.com/v1/api/01-web-to-markdown
• Authentication: Generic Credential Header Authorization: Bearer topai_live_xxx
• JSON Body: {"url": "={{ $json.target_url }}"}

🐍 Python & TypeScript Client Snippets

const res = await fetch("https://gateway.topaigateway.com/v1/api/05-semantic-cache", {
  method: "POST",
  headers: {
    "Authorization": "Bearer topai_live_YOUR_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ query: "Extract user balance", namespace: "banking" })
});
const data = await res.json();
console.log(data);

⚖️ Enterprise Cyber & Regulatory Compliance (CISO Dossier)

📄 Official Master Architecture Guide (91 Pages)