Passerelle API compatible OpenAI pour modèles souverains. Routez, sécurisez et observez chaque requête depuis un seul endpoint.
API CENTRALE
Routage et observabilité intégrés pour l'IA d'entreprise.
Un seul endpoint pour des modèles arabes natifs, multilingues et vos modèles fine-tunés.
Budgets par équipe, quotas de tokens et attribution vérifiable.
Journal d'activité local avec preuves de résidence des données.
Inférence on-premise près de vos données, pas à l'autre bout du monde.
DÉMARRER
Votre première requête en quelques minutes.
Clés par équipe, rotation planifiée et listes d'IP autorisées.
Utilisez les SDK OpenAI et changez seulement le `baseURL`.
Choisissez un modèle ou laissez le routage gérer coût, latence et souveraineté.
INTÉGRATION
Passez en quelques minutes. Pointez `baseURL` vers MX4 Platform et gardez vos outils OpenAI.
import OpenAI from 'openai';
// Example: point the OpenAI client to MX4 Platform
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 MX4 Platform routing hints
extra_body: {
routing_preference: 'cost', // cost | performance | balanced
}
});
console.log(completion.choices[0].message);| Famille Falcon | Variable | Arabe natif |
| Famille JAIS | Variable | Arabe natif |
| Famille Llama | Variable | Anglais / Code |
| Famille Qwen | Variable | Multilingue |
OUTILS DÉVELOPPEUR
Démarrez rapidement avec les bibliothèques officiellement supportées.
pip install mx4-atlasDernière versionnpm install @mx4/atlasDernière versiongo get github.com/mx4/atlas-goDernière versionmaven: com.mx4.atlasDernière versionROUTAGE
Routage piloté par règles : coût, performance, langue et résidence des données.
Routez les requêtes simples vers des modèles plus petits et plus économiques.
Assurez-vous que les données sensibles restent sur site en imposant des routes locales.
Routez automatiquement les prompts en arabe vers des modèles spécialisés.
# 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"RÉFÉRENCE API
Endpoints représentatifs compatibles OpenAI (peuvent varier selon le déploiement).
| En-tête | Description |
|---|---|
| X-Sovereign-ID | Identifiant unique de l'enclave souveraine traitant la requête. |
| X-Audit-Trace-ID | Identifiant de trace reliant la requête au journal d'activité infrastructure. |
| X-Route-Policy | Règle de routage appliquée (ex. local-only, latence optimisée). |
| X-Data-Residency | Localisation confirmée du traitement des données (ex. : "region-1"). |
| Code | Signification |
|---|---|
| 400 Bad Request | Entrée invalide ou JSON mal formé. |
| 401 Unauthorized | Clé API invalide ou manquante. |
| 403 Forbidden | Permissions insuffisantes (RBAC) ou violation de règle de souveraineté des données. |
| 429 Too Many Requests | Limite de débit dépassée (par clé ou par IP). |
| 451 Unavailable For Legal Reasons | Bloqué par Sovereignty Guard (ex. : violation de résidence des données). |
SÉCURITÉ
Chaque requête inclut une clé valide. Les clés sont associées à des équipes et suivies pour l'usage et les 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"}]
}'OBSERVABILITÉ
Les requêtes peuvent être journalisées localement avec une chaîne de hachage et une preuve de résidence.
Les entrées sont stockées localement avec chaînage pour l'intégrité.
Vous contrôlez la rétention, l'accès et l'export sur votre 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"
}LIMITES DE DÉBIT
Limites indicatives ; configurées selon le déploiement.
| Forfait | Requêtes/min | Tokens/jour | Burst |
|---|---|---|---|
| Développement | Faible | Faible | Petit |
| Professionnel | Moyen | Moyen | Modéré |
| Entreprise | Personnalisé | Personnalisé | Personnalisé |
Chaque réponse inclut des en-têtes indiquant vos limites actuelles et votre quota restant :
WEBHOOKS
Notifications en temps réel pour opérations asynchrones, règles de routage et seuils de coût.
{
"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"
}
}VERSIONNAGE
MX4 Platform suit le versionnage sémantique. Les versions exactes sont fixées par déploiement.
Récent
Récent
Récent
FAQ
Questions fréquentes sur l'intégration avec MX4 Platform.
Oui. Changez simplement le base_url vers votre instance MX4 Platform et utilisez votre clé API MX4 Platform. Notre API est compatible avec le format de complétions de chat d'OpenAI.
Définissez stream: true dans votre requête. MX4 Platform renvoie des Server-Sent Events (SSE) compatibles avec le format de streaming d'OpenAI.
Vous recevrez une erreur 429 avec des en-têtes indiquant quand votre quota sera réinitialisé. Les forfaits Entreprise peuvent inclure des burst.
Nous pouvons provisionner un environnement d'évaluation de courte durée via le Test Access Program. Contactez-nous pour y accéder.
La tarification varie selon le modèle et le volume. Contactez-nous pour les dernières indications.
SUPPORT
Support pratique pour l'intégration, la migration et l'optimisation.