dokumentasi
Automasi

Bot Telegram

Markdown

Bot · OpenAI Chat

Panduan lengkap
FormatTempat membuat tetapan
OpenAI ChatRangka kerja Telegram tidak mempunyai lapisan LLM sendiri: pengendali mesej memanggil OpenAI SDK dengan base_url Ailoot (atau Anthropic SDK dengan base_url tanpa /v1)

Konfigurasi

Salin konfigurasi dan gantikan sk-... dengan kunci anda daripada panel pengguna Ailoot. Sebaiknya simpan kunci dalam pemboleh ubah persekitaran AILOOT_API_KEY, jika aplikasi menyokongnya.

Sebelum bermula, panggil GET /v1/models dengan kunci Ailoot anda. Pilih ID model tepat yang kaedahnya merangkumi POST /v1/chat/completions, kemudian gunakannya dalam konfigurasi. Untuk ejen, semak juga sokongan alat dan ciri yang diperlukan oleh versi klien anda.

Simpan kod Python sebagai ailoot-telegram-bot.py. Pasang kebergantungan, tetapkan kedua-dua pemboleh ubah persekitaran dan jalankan fail. Hantar Hello kepada bot dan semak balasan teks. Jika berlaku ralat, simpan Request ID dan semak hasil asal sebelum menghantar permintaan penjanaan lain.

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

Contoh model: claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash. Ambil mana-mana model lain daripada katalog — pastikan model mempunyai format yang diperlukan.

Perkara yang perlu diketahui

Semakan

  • Alamat untuk format OpenAI ialah https://api.ailoot.ai/v1 (atau laluan penuh, jika aplikasi meminta alamat penuh).
  • Ajukan soalan ringkas. Jika ralat diterima, semak kod dan Request ID serta rujuk halaman Ralat dan had.
  • 404 sejurus selepas konfigurasi hampir selalu bermaksud alamat tidak betul: terdapat lebihan atau kekurangan /v1.
  • 402 — baki tidak mencukupi untuk rizab. Ejen merizabkan lebih banyak daripada sembang: sebabnya.

Dokumentasi aplikasi: https://github.com/openai/openai-python

Masih ada soalan? Hantar Request ID dan penerangannya — kami akan membantu menyiasatnya.Hubungi sokongan