OneMux/Documentation/Génération de conversations

Génération de conversations

Point de terminaison standard de génération de conversations, compatible avec les principaux modèles, notamment OpenAI, Anthropic et Google. Prend en charge les conversations à plusieurs tours, les invites système, la sortie en continu et le réglage des paramètres. Cette page présente le format des requêtes, la structure des réponses, les paramètres courants et la gestion des erreurs.

Informations sur l’interface

Point de terminaison : POST /v1/chat/completions
Authentification : Authorization: Bearer sk-xxx
Protocole : format compatible avec OpenAI

Appel de base

curl https://api.onemux.net/v1/chat/completions \
  -H "Authorization: Bearer $ONEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role": "user", "content": "Bonjour, OneMux"}]
  }'

Exemple de réponse

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gpt-6.1-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Bonjour ! Je suis l’assistant IA OneMux..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

Conversations à plusieurs tours

Le tableau messages conserve l’historique dans l’ordre chronologique :

response = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[
        {"role": "user", "content": "Je m'appelle Xiao Ming"},
        {"role": "assistant", "content": "Bonjour, Xiao Ming !"},
        {"role": "user", "content": "Comment est-ce que je m'appelle ?"}
    ]
)
# L’IA répondra : Tu t’appelles Xiao Ming

Invite système

Utilisez le rôle system pour définir les règles de comportement de l’IA :

messages = [
    {"role": "system", "content": "Vous êtes un ingénieur Python expérimenté. Répondez de manière concise et professionnelle."},
    {"role": "user", "content": "Comment lire un fichier ?"}
]

Paramètres courants

Paramètre	Description	Valeur recommandée
temperature	Créativité (0-2)	0.7 (par défaut), 1.2 pour l’écriture créative, 0.3 pour la génération de code
max_tokens	Longueur maximale de sortie	À définir selon les besoins pour éviter les réponses trop longues du modèle
top_p	Échantillonnage nucleus (0-1)	0.9 (par défaut)
stream	Sortie en continu	true (recommandé pour une meilleure expérience)