OpenAI-compatible API gateway for sovereign models. Route, secure, and observe every request from one endpoint.
CORE API
Routing and observability baked in for enterprise deployments.
One endpoint for Arabic-native, multilingual, and your fine-tuned checkpoints.
Per-team budgets, token caps, and attribution you can review.
Local infrastructure activity journal with residency evidence.
On-prem inference next to your data, not across oceans.
GET STARTED
Your first request in a few minutes.
Create team-scoped keys, rotate on schedule, and set IP allowlists.
Use the OpenAI SDKs and switch `baseURL` to your Atlas endpoint.
Pick a model or let routing handle cost, latency, and sovereignty.
INTEGRATION
Switch in minutes. Point `baseURL` to Atlas and keep the same OpenAI tooling.
import OpenAI from 'openai';
// Example: point the OpenAI client to Atlas
const client = new OpenAI({
apiKey: 'mx4_sk_live_...',
baseURL: 'https://api.your-domain/v1',
});
// Use standard Chat Completions
const completion = await client.chat.completions.create({
model: 'auto-router',
messages: [
{ role: 'user', content: 'لخص هذا التقرير المالي' }
],
// Optional Atlas routing hints
extra_body: {
routing_preference: 'cost', // cost | performance | balanced
}
});
console.log(completion.choices[0].message);| Falcon family | Varies | Arabic Native |
| JAIS family | Varies | Arabic Native |
| Llama family | Varies | English / Code |
| Qwen family | Varies | Multilingual |
DEVELOPER TOOLS
Start fast with officially supported client libraries.
pip install mx4-atlasLatestnpm install @mx4/atlasLatestgo get github.com/mx4/atlas-goLatestmaven: com.mx4.atlasLatestROUTING
Rule-driven routing across cost, performance, language, and residency requirements.
Route simple queries to smaller, cost-efficient models.
Ensure sensitive data stays on-prem by forcing local routes.
Automatically route Arabic prompts to specialized Arabic models.
# Example routing policy (illustrative)
routes:
# Route Arabic to specialized models
- name: "arabic-native"
condition: "language == 'ar'"
model: "arabic-large"
# Cost optimization for simple queries
- name: "fast-path"
condition: "prompt_tokens < 100"
model: "general-small"API REFERENCE
Representative endpoints with OpenAI-compatible semantics (may vary by deployment).
| Header | Description |
|---|---|
| X-Sovereign-ID | Unique identifier for the sovereign enclave processing the request. |
| X-Audit-Trace-ID | Trace ID linking the request to the infrastructure activity journal. |
| X-Route-Policy | Routing policy applied (e.g., local-only, latency-optimized). |
| X-Data-Residency | Confirmed location of data processing (e.g., "region-1"). |
| Code | Meaning |
|---|---|
| 400 Bad Request | Invalid input or malformed JSON. |
| 401 Unauthorized | Invalid or missing API key. |
| 403 Forbidden | Insufficient permissions (RBAC) or data sovereignty rule violation. |
| 429 Too Many Requests | Rate limit exceeded (per-key or per-IP). |
| 451 Unavailable For Legal Reasons | Blocked by Sovereignty Guard (e.g., data residency violation). |
SECURITY
All requests include a valid API key. Keys are scoped by team and tracked for usage and quotas.
curl -X POST https://api.your-domain/v1/chat/completions \
-H "Authorization: Bearer mx4_sk_live_abc123..." \
-H "Content-Type: application/json" \
-d '{
"model": "model_chat",
"messages": [{"role": "user", "content": "Hello"}]
}'OBSERVABILITY
Requests can be logged locally with a cryptographic hash chain and residency evidence.
Entries are stored locally with hash-chaining for integrity.
You control retention, access, and export on your infrastructure.
{
"timestamp": "2026-02-04T14:23:45Z",
"request_id": "req-uuid-12345",
"actor_id": "user-xyz",
"action": "chat.completions",
"model": "routed-model",
"prompt_hash": "sha256:a3f7d2...",
"routing_policy": "sovereign_enforcement",
"residency_boundary": "region-1",
"journal_hash": "sha256:8b12c4...",
"status": "success"
}RATE LIMITS
Illustrative limits; configured per deployment.
| Plan | Requests/min | Tokens/day | Burst |
|---|---|---|---|
| Development | Low | Low | Small |
| Professional | Medium | Medium | Moderate |
| Enterprise | Custom | Custom | Custom |
Every response includes headers showing your current limits and remaining quota:
WEBHOOKS
Real-time notifications for async operations, routing rules, and cost thresholds.
{
"event": "guardrail.violation",
"timestamp": "2026-02-04T14:30:00Z",
"request_id": "req_abc123",
"details": {
"violation_type": "pii_detected",
"entities": ["email", "phone"],
"action_taken": "request_blocked"
},
"metadata": {
"team_id": "team_xyz",
"user_id": "user_789"
}
}VERSIONING
Atlas follows semantic versioning. Exact versions are pinned per deployment.
Recent
Recent
Recent
FAQ
Common questions about integrating with Atlas.
Yes. Change the base_url to your Atlas instance and use your Atlas API key. Our API is compatible with OpenAI's chat completions format.
Set stream: true in your request. Atlas returns Server-Sent Events (SSE) compatible with OpenAI's streaming format.
You'll receive a 429 error with headers indicating when your quota resets. Enterprise plans can include burst allowances.
We can provision a short-lived evaluation environment through the Test Access Program. Contact us for access.
Pricing varies by model and volume. Contact us for the latest pricing guidance.
SUPPORT
Hands-on support for integration, migration, and optimization.