{
  "openapi": "3.1.0",
  "info": {
    "title": "DimaRouter API",
    "version": "1.0.0",
    "description": "API d’inférence compatible OpenAI et Anthropic. Prix en MAD par million de tokens. Documentation : https://dimarouter.ma/llms.txt",
    "contact": {
      "name": "iAvicenne Maroc SARLAU",
      "email": "sales@dimarouter.ma",
      "url": "https://dimarouter.ma"
    }
  },
  "servers": [
    {
      "url": "https://api.dimarouter.ma/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Clé API dima_live_…"
      }
    },
    "schemas": {
      "Message": {
        "type": "object",
        "required": [
          "role",
          "content"
        ],
        "properties": {
          "role": {
            "type": "string",
            "enum": [
              "system",
              "user",
              "assistant",
              "tool"
            ]
          },
          "content": {}
        }
      },
      "ChatCompletionRequest": {
        "type": "object",
        "required": [
          "model",
          "messages"
        ],
        "properties": {
          "model": {
            "type": "string",
            "enum": [
              "deepseek-ai/DeepSeek-V4.1-Flash-1017",
              "moonshotai/Kimi-K3.1-Pro",
              "zai-org/GLM-5.3-Flash",
              "Qwen/Qwen3.8-Max",
              "deepseek-ai/DeepSeek-V4-Flash-0731",
              "Qwen/Qwen3.8-Flash",
              "google/gemma-4-31B-it",
              "Qwen/Qwen3.6-35B-A3B",
              "nvidia/NVIDIA-Nemotron-3-Super-120B-A12B",
              "moonshotai/Kimi-K3",
              "zai-org/GLM-5.3",
              "zai-org/GLM-5.2",
              "deepseek-ai/DeepSeek-V4-Pro-0813",
              "deepseek-ai/DeepSeek-V4.1-Flash",
              "meta/Muse-Spark-Open",
              "meta/Muse-Glimmer-30B",
              "nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B",
              "Qwen/Qwen3.8-27B",
              "Qwen/Qwen3-VL-235B-A22B-Instruct",
              "Qwen/Qwen3.5-35B-A3B-Structured"
            ]
          },
          "messages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Message"
            }
          },
          "max_tokens": {
            "type": "integer"
          },
          "temperature": {
            "type": "number"
          },
          "stream": {
            "type": "boolean"
          },
          "tools": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    }
  },
  "paths": {
    "/models": {
      "get": {
        "summary": "Catalogue des modèles et prix en MAD (public)",
        "responses": {
          "200": {
            "description": "Liste des modèles.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/chat/completions": {
      "post": {
        "summary": "Chat Completions (compatible OpenAI)",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChatCompletionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Réponse du modèle ; en-tête x-dima-cost-mad = coût de la requête.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Clé API absente ou invalide."
          },
          "402": {
            "description": "Solde insuffisant."
          },
          "429": {
            "description": "Trop de requêtes."
          }
        }
      }
    },
    "/responses": {
      "post": {
        "summary": "Responses (compatible OpenAI, utilisé par Codex)",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Réponse.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Clé API absente ou invalide."
          },
          "402": {
            "description": "Solde insuffisant."
          },
          "429": {
            "description": "Trop de requêtes."
          }
        }
      }
    },
    "/messages": {
      "post": {
        "summary": "Messages (compatible Anthropic, utilisé par Claude Code)",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Réponse.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Clé API absente ou invalide."
          },
          "402": {
            "description": "Solde insuffisant."
          },
          "429": {
            "description": "Trop de requêtes."
          }
        }
      }
    },
    "/batches": {
      "get": {
        "summary": "Lister les lots",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Lots.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Clé API absente ou invalide."
          }
        }
      },
      "post": {
        "summary": "Créer un lot (traitement sous 24 h)",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Lot créé.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Clé API absente ou invalide."
          },
          "402": {
            "description": "Solde insuffisant."
          },
          "429": {
            "description": "Trop de requêtes."
          }
        }
      }
    }
  },
  "x-mcp-server": {
    "url": "https://api.dimarouter.ma/mcp",
    "transport": "streamable-http",
    "docs": "https://dimarouter.ma/docs/mcp.md"
  }
}