Guide rapide pour les utilisateurs de Mistral

URL de base et authentification

Notre API est entièrement compatible avec les SDK OpenAI. Vous devez uniquement mettre à jour l'URL de base et fournir votre clé API. L'URL de base pour ce service est https://api.mistralapi.com/v1. L'authentification est gérée via l'en-tête Authorization en utilisant un jeton Bearer. Contrairement à certains fournisseurs, nous ne nécessitons pas de routage complexe ni d'en-têtes spécifiques au fournisseur ; transmettez simplement votre clé comme d'habitude.

• URL de base : https://api.mistralapi.com/v1
• En-tête : Authorization: Bearer YOUR_API_KEY

Votre clé API est générée immédiatement après l'inscription. Gardez-la en sécurité, car elle donne accès à votre crédit prépayé. Il n'y a pas de frais d'abonnement mensuels, uniquement un paiement à l'usage basé sur l'utilisation des tokens.

Endpoint Chat Completions

Le cœur de notre API est l'endpoint POST /v1/chat/completions. Il accepte une liste de messages et renvoie une réponse générée. Cet endpoint prend en charge le format de message standard utilisé par la plupart des clients LLM. Vous devez spécifier l'ID du modèle comme "uncensored". Ce modèle est un grand modèle de langage à poids ouverts hébergé sur nos serveurs, ajusté pour répondre sans refus de contenu pour un usage adulte légal.

• Endpoint : POST /v1/chat/completions
• ID du modèle : uncensored

L'API renvoie uniquement des réponses textuelles. Elle ne prend pas en charge les images, l'audio, la vidéo ou les embeddings. Pour la plupart des développeurs, cet endpoint remplace l'endpoint de chat standard d'OpenAI sans modification de code au-delà de l'URL de base et de l'ID du modèle.

Intégration SDK Python

L'utilisation de la bibliothèque Python officielle OpenAI est le moyen le plus rapide d'intégrer. Définissez l'URL de base sur notre endpoint et fournissez votre clé API. Le code ci-dessous illustre une simple demande de complétion de texte.

• Installez la bibliothèque : pip install openai
• Définissez base_url sur https://api.mistralapi.com/v1
• Utilisez model="uncensored"

Cette approche fonctionne car notre API imite la structure de réponse d'OpenAI. Vous pouvez utiliser des bibliothèques existantes pour le streaming, l'appel de fonctions et le mode JSON sans modification.

Intégration SDK Node.js

Pour les développeurs JavaScript/TypeScript, le package npm openai fonctionne parfaitement. Configurez le client avec notre URL de base et votre clé API. Cela vous permet d'utiliser la même base de code pour OpenAI et notre modèle sans censure.

• Installez la bibliothèque : npm install openai
• Configurez baseUrl sur https://api.mistralapi.com/v1
• Spécifiez model: "uncensored"

Cette compatibilité s'étend à tous les paramètres standard comme temperature, top_p et les séquences stop. Vous pouvez passer facilement d'un fournisseur à l'autre en modifiant la configuration du client.

Réponses en streaming

Nous prenons en charge les réponses en streaming via les événements envoyés par le serveur (SSE). Cela vous permet de recevoir des tokens au fur et à mesure de leur génération, réduisant la latence perçue pour les utilisateurs. Le dernier fragment du flux inclut les statistiques d'utilisation des tokens pour la facturation.

• Définissez stream: true dans votre requête
• Lisez les fragments de la réponse
• Analysez le dernier fragment pour les données d'utilisation

Le streaming est idéal pour les interfaces de chat et les applications en temps réel. Le format de réponse correspond à la norme de streaming d'OpenAI, donc votre logique de streaming existante fonctionnera sans modifications.

Limites, erreurs et fenêtre de contexte

Notre API a des limites spécifiques pour garantir la stabilité. Chaque clé API prend en charge 300 requêtes par minute et 8 requêtes simultanées. La taille maximale du corps de la requête est de 8 Mo. La fenêtre de contexte est de 100 000 tokens au total (prompt + complétion). Si vous ne définissez pas max_tokens, la sortie par défaut est de 2 048 tokens ; sinon, la sortie maximale est de 32 000 tokens.

• 401: Clé API invalide
• 402: Crédit insuffisant
• 429: Limite de débit dépassée

Le crédit premium n'expire jamais. Les erreurs et les refus sont gratuits. Si vous rencontrez des problèmes, utilisez la page Support pour les remboursements ou l'aide au compte.

cURL

Copiercurl https://api.mistralapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copierfrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copierimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

Copierstream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)