Skip to content

Documentation API ​

Une API LLM compatible OpenAI pour intégrer facilement l'IA dans vos applications.

Démarrage rapide ​

💡 Pour un usage intensif (Mammouth Code, Cline), préférez Starter + ~50 $ de crédits API plutôt que Expert.

➡️ Obtenez votre clé API et vos crédits.

Avec l'API Mammouth directement ​

Génère une réponse de complétion de chat basée sur votre prompt.

python
import requests
url = "https://api.mammouth.ai/v1/chat/completions"
headers = {
    "Authorization": "Bearer VOTRE_CLE_API",
    "Content-Type": "application/json"
}
data = {
    "model": "gpt-4.1",
    "messages": [
        {
            "role": "user",
            "content": "Explique les bases de l'apprentissage automatique"
        }
    ]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
javascript
const fetch = require("node-fetch");

async function callMammouth() {
  const url = "https://api.mammouth.ai/v1/chat/completions";
  const headers = {
    Authorization: "Bearer VOTRE_CLE_API",
    "Content-Type": "application/json",
  };

  const data = {
    model: "gpt-4.1",
    messages: [
      {
        role: "user",
        content: "Crée un exemple de fonction JavaScript",
      },
    ],
  };

  try {
    const response = await fetch(url, {
      method: "POST",
      headers: headers,
      body: JSON.stringify(data),
    });

    const result = await response.json();
    console.log(result.choices[0].message.content);
  } catch (error) {
    console.error("Erreur:", error);
  }
}

callMammouth();
bash
curl -X POST https://api.mammouth.ai/v1/chat/completions \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "messages": [
      {
        "role": "user",
        "content": "Salut, comment allez-vous ?"
      }
    ]
  }'

➡️ Obtenez votre clé API et vos crédits.

Avec la bibliothèque OpenAI ​

python
import openai

# Configurer le client pour utiliser Mammouth.ai
openai.api_base = "https://api.mammouth.ai/v1"
openai.api_key = "VOTRE_CLE_API"

response = openai.ChatCompletion.create(
    model="gpt-4.1",
    messages=[
        {"role": "user", "content": "Quels sont les avantages des énergies renouvelables ?"}
    ]
)

print(response.choices[0].message.content)

Format de réponse ​

Réponse réussie ​

json
{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-4.1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Bonjour ! Je vais très bien, merci de demander. Comment puis-je vous aider aujourd'hui ?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 19,
    "total_tokens": 31
  }
}

Réponse en streaming ​

Quand stream: true est défini, les réponses sont retournées sous forme de Server-Sent Events :

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1677652288,"model":"gpt-4.1","choices":[{"index":0,"delta":{"content":"Hello"},"finish_reason":null}]}

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1677652288,"model":"gpt-4.1","choices":[{"index":0,"delta":{"content":"!"},"finish_reason":null}]}

data: [DONE]
json
{
  "id": "gen-1767710235-3VtWd1SuI9ilIspBmeWG",
  "created": 1767710235,
  "model": "google/gemini-2.5-flash-image",
  "object": "chat.completion",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "Voici un magnifique couché de soleil pour vous!",
        "role": "assistant",
        "images": [
          {
            "image_url": {
              "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAI..."
            }
          }
        ]
      }
    }
  ]
}

Modèles et tarifs ​

mammouth-recommended est un raccourci vers le modèle que Mammouth considère actuellement comme offrant le meilleur rapport qualité-prix.

Pointez vos requêtes vers lui et vous obtiendrez toujours notre choix du moment, sans avoir à suivre vous-même les nouvelles sorties.

  • Choix actuel : glm-5.3-flash, avec minimax-m3 en repli (fallback). Ce choix évoluera au fil du temps, à mesure que de nouveaux modèles sortent.
  • Comment l'utiliser : appelez-le exactement comme n'importe quel autre modèle. Indiquez mammouth-recommended comme modèle, ou utilisez les raccourcis mammouth ou recommended.
  • Tarification : vous payez le même prix que le modèle sous-jacent, sans majoration ; consultez donc sa ligne dans le tableau ci-dessous.

Tous les modèles ​

Liste non exhaustive. Consulter la liste complète et à jour ici.

ModelInput ($/M tokens)Output ($/M tokens)
claude-fable-5.11050
claude-haiku-4-515
claude-opus-5-5420
claude-sonnet-5210
deepseek-v4-pro1.743.48
deepseek-v4.1-flash0.220.66
gemini-3.1-flash-image-previewimage/
gemini-3.1-pro-preview212
gemini-3.7-flash1.57.5
gemini-3.8-flash0.753.75
glm-5.31.44.4
glm-5.3-flash0.150.5
gpt-5.42.515
gpt-5.4-mini0.754.5
gpt-5.4-nano0.21.25
gpt-5.5530
gpt-6-astra1050
gpt-6-luna0.10.5
gpt-6-sol210
grok-4.726
kimi-k2.60.733.49
kimi-k3315
llama-4-maverick0.150.6
minimax-m30.31.2
mistral-medium-3-51.57.5
mistral-small-3.2-24b-instruct0.10.3
qwen3.7-plus0.41.6
qwen3.8-27b0.42.55
qwen3.8-flash0.150.47
sonar-deep-research28
sonar-pro315

À propos des tarifs

Les prix indiqués ici sont des plafonds.

Ce que vous payez réellement est parfois inférieur, car le prix dépend de la disponibilité des fournisseurs.

Vous ne serez jamais facturé au-delà du prix affiché.

Embeddings ​

Générez des embeddings vectoriels pour du texte à utiliser dans la recherche sémantique, le clustering et d'autres tâches NLP.

Modèles d'embedding et tarifs ​

ModèleEntrée ($/M tokens)
text-embedding-3-large0.13
text-embedding-3-small0.02

Exemple d'embedding ​

python
import requests

url = "https://api.mammouth.ai/v1/embeddings"
headers = {
    "Authorization": "Bearer VOTRE_CLE_API",
    "Content-Type": "application/json"
}
data = {
    "model": "text-embedding-3-large",
    "input": "Bonjour le monde !"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

Réponse d'embedding ​

json
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0091, 0.0152, ...]
    }
  ],
  "model": "text-embedding-3-large",
  "usage": {
    "prompt_tokens": 4,
    "total_tokens": 4
  }
}

📜 L'utilisation et les coûts sont loggés dans vos paramètres.

💡 Nous avons ajouté des alias alignés avec l'app Mammouth pour faciliter la sélection de modèles : si vous écrivez mistral, cela utilisera mistral-medium-3.1 automatiquement.

Codes d'erreur ​

CodeDescription
400Requête incorrecte - Paramètres manquants ou incorrects
401Non autorisé - Clé API invalide
429Trop de requêtes - Limite de débit dépassée
500Erreur serveur interne - Problème côté serveur
503Service indisponible - Serveur temporairement indisponible

Suivre les dépenses ​

Si vous souhaitez savoir combien de crédits ont été dépensés pour une clé, utilisez :

bash
curl -X GET "https://api.mammouth.ai/key/info" -H "Authorization: Bearer $MAMMOUTH_API_KEY"

Paramètres ​

Paramètres requis ​

ParamètreTypeDescription
messagesarrayListe des messages dans la conversation
modelstringIdentificateur du modèle à utiliser

Paramètres optionnels ​

ParamètreTypeDéfautDescription
temperaturenumber0.7Contrôle la créativité (0.0 à 2.0)
max_tokensinteger2048Nombre maximum de tokens à générer
top_pnumber1.0Contrôle la diversité des réponses
streambooleanfalseStreaming de réponse en temps réel

Notre API prend également en charge les paramètres et fonctionnalités propres aux fournisseurs, comme l'effort de raisonnement, les appels d'outils et de fonctions, ainsi que le mode thinking. Leur disponibilité dépend du fournisseur et du modèle.

Conseils d'optimisation ​

Structure des messages ​

json
{
  "messages": [
    {
      "role": "system",
      "content": "Vous êtes un assistant IA spécialisé en programmation."
    },
    {
      "role": "user",
      "content": "Comment optimiser une boucle for en Python ?"
    }
  ]
}

Types de rôles ​

  • system : Définit le comportement et le contexte de l'assistant
  • user : Représente les messages de l'utilisateur
  • assistant : Représente les réponses précédentes de l'IA

Migration depuis OpenAI ​

Si vous utilisez déjà l'API OpenAI, migrer vers Mammouth.ai est simple :

  1. Changez l'URL de base de https://api.openai.com/v1 à https://api.mammouth.ai/v1
  2. Mettez à jour votre clé API
  3. Gardez tous les autres paramètres identiques

Bibliothèque Python OpenAI ​

python
import openai

# Avant
openai.api_base = "https://api.openai.com/v1"
openai.api_key = "sk-openai-key"

# Après
openai.api_base = "https://api.mammouth.ai/v1"
openai.api_key = "votre-cle-mammouth"

n8n, VS Code, Cline, OpenClaw, Make, CLI, etc. ​

Vous pouvez utiliser l'API Mammouth avec des outils tels que n8n, VS Code, Cline, Make et bien d'autres.

Assurez-vous d'utiliser l'URL correcte. En cas de doute, essayez chacune d'entre elles.

Tutoriels sur l'utilisation de l'API Mammouth dans vos outils préférés ​

Pour les automatisations :

Pour les IDE :

Pour CLI (équivalent de Claude Code) :

Ou via Opencode

Autres

​