Bot Telegram
MarkdownBots · OpenAI Chat
Guide complet
| Format | Où configurer |
|---|---|
| OpenAI Chat | Les 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 stocker 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" openaiailoot-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.pyExemple 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 : pourquoi.
Documentation de l’application : https://github.com/openai/openai-python