docs
Automatisation

Bot Telegram

Markdown

Bots · OpenAI Chat

Guide complet
FormatOù configurer
OpenAI ChatLes frameworks Telegram ne possèdent pas de couche LLM propre : le gestionnaire de messages appelle le SDK OpenAI avec base_url Ailoot, ou le SDK Anthropic avec base_url sans /v1

Configuration

Copiez la configuration et remplacez sk-... par votre clé de l’espace client Ailoot. Il est préférable de conserver la clé dans la variable d’environnement AILOOT_API_KEY, si l’application le permet.

Avant de démarrer, appelez GET /v1/models avec votre clé Ailoot. Choisissez un identifiant exact de modèle dont les méthodes incluent POST /v1/chat/completions, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du client.

Enregistrez le code Python dans ailoot-telegram-bot.py. Installez les dépendances, définissez les deux variables d’environnement, puis lancez le fichier. Envoyez Hello au bot et vérifiez la réponse textuelle. En cas d’erreur, conservez le Request ID et vérifiez le résultat initial avant une nouvelle génération.

python3 -m pip install "aiogram>=3,<4" openai

ailoot-telegram-bot.py

import asyncio
import os
from aiogram import Bot, Dispatcher, F
from aiogram.types import Message
from openai import AsyncOpenAI, APIError

async def main():
    dp = Dispatcher()
    async with AsyncOpenAI(
        base_url="https://api.ailoot.ai/v1",
        api_key=os.environ["AILOOT_API_KEY"],
        max_retries=0,
    ) as llm:
        @dp.message(F.text)
        async def reply(message: Message):
            try:
                result = await llm.chat.completions.create(
                    model="claude-sonnet-5-5",
                    messages=[{"role": "user", "content": message.text}],
                )
                content = result.choices[0].message.content or "—"
                for start in range(0, len(content), 4000):
                    await message.answer(content[start:start + 4000])
            except APIError as error:
                await message.answer(
                    f"{type(error).__name__}; Request ID: "
                    f"{getattr(error, 'request_id', None) or '—'}"
                )
        bot = Bot(token=os.environ["TELEGRAM_BOT_TOKEN"])
        await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())
export AILOOT_API_KEY="sk-..."
export TELEGRAM_BOT_TOKEN="<TELEGRAM_BOT_TOKEN>"
python3 ailoot-telegram-bot.py

Exemple de modèle : claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash. Choisissez tout autre modèle dans le catalogue — vérifiez qu’il prend en charge le format requis.

À savoir

Vérification

  • Pour le format OpenAI, l’adresse est https://api.ailoot.ai/v1 (ou le chemin complet si l’application demande une adresse complète).
  • Posez une question courte. En cas d’erreur, consultez le code et le Request ID, puis reportez-vous à la page Erreurs et limites.
  • Une erreur 404 immédiatement après la configuration indique presque toujours une adresse incorrecte : la présence superflue ou l’absence de /v1.
  • Une erreur 402 signifie que le solde ne couvre pas la réservation. Les agents réservent plus qu’un chat : explication.

Documentation de l’application : https://github.com/openai/openai-python

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à l’analyser.Contacter l’assistance