docs
Автоматтандыру

Telegram боты

Markdown

Боттар · OpenAI Chat

Толық нұсқаулық
ФорматҚайда баптау керек
OpenAI ChatTelegram фреймворктерінде өз LLM қабаты жоқ: хабарлама өңдеушісінде Ailoot base_url мекенжайы бар OpenAI SDK шақырылады (немесе /v1 бөлігісіз base_url бар Anthropic SDK)

Баптау

Конфигурацияны көшіріп, мынаны ауыстырыңыз: sk-... Ailoot жеке кабинетіңіздегі кілтке. Кілтті мына орта айнымалысында сақтаған дұрыс: AILOOT_API_KEY, қолданба мұны қолдаса.

Іске қоспас бұрын Ailoot кілтіңізбен GET /v1/models сұрауын жіберіңіз. Әдістері POST /v1/chat/completions қамтитын нақты модель ID мәнін таңдап, баптауда қолданыңыз. Агенттер үшін клиент нұсқасына қажетті құралдар мен мүмкіндіктердің қолдауын да тексеріңіз.

Python кодын ailoot-telegram-bot.py атауымен сақтаңыз. Тәуелділіктерді орнатып, екі орта айнымалысын беріңіз де, файлды іске қосыңыз. Ботқа Hello жіберіп, мәтіндік жауапты тексеріңіз. Қате кезінде Request ID мәнін сақтап, жаңа генерация жібермес бұрын бастапқы нәтижені тексеріңіз.

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

Модель мысалы: claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash. Кез келген басқа модельді мына жерден алыңыз: каталогтан — оның қажетті форматты қолдайтынын тексеріңіз.

Білу маңызды

Тексеру

  • OpenAI форматы үшін мекенжай — https://api.ailoot.ai/v1 (немесе қолданба толық мекенжай сұраса, толық жол).
  • Қысқа сұрақ қойыңыз. Қате келсе, код пен Request ID-ді қарап, мына бетпен салыстырыңыз: Қателер және лимиттер.
  • Баптаудан кейін бірден шыққан 404 әрдайым дерлік мекенжайдың қате екенін білдіреді: артық немесе жетіспейтін /v1.
  • 402 — резервке баланс жетпейді. Агенттер чатқа қарағанда көбірек резервтейді: неге.

Қолданба құжаттамасы: https://github.com/openai/openai-python

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.Қолдау қызметіне жазу