dokumentasi
Otomatisasi

Bot Telegram

Markdown

Bot · OpenAI Chat

Panduan lengkap
FormatTempat mengatur
OpenAI ChatFramework Telegram tidak memiliki lapisan LLM sendiri: handler pesan memanggil OpenAI SDK dengan base_url Ailoot (atau Anthropic SDK dengan base_url tanpa /v1)

Konfigurasi

Salin konfigurasi dan ganti sk-... dengan kunci Anda dari dasbor Ailoot. Sebaiknya simpan kunci dalam variabel lingkungan AILOOT_API_KEY, jika aplikasi mendukungnya.

Sebelum menjalankan, panggil GET /v1/models dengan kunci Ailoot Anda. Pilih ID model yang tepat dengan metode POST /v1/chat/completions, lalu gunakan ID tersebut dalam konfigurasi. Untuk agen, periksa juga dukungan alat dan fitur yang diperlukan versi klien Anda.

Simpan kode Python sebagai ailoot-telegram-bot.py. Instal dependensi, atur kedua variabel lingkungan, lalu jalankan berkas. Kirim Hello ke bot dan periksa balasan teksnya. Jika terjadi kesalahan, simpan Request ID dan periksa hasil awal sebelum mengirim permintaan pembuatan 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 model lain dari katalog — pastikan format yang diperlukan tersedia.

Hal yang perlu diketahui

Pemeriksaan

  • Untuk format OpenAI, alamatnya — https://api.ailoot.ai/v1 (atau jalur lengkap jika aplikasi meminta alamat lengkap).
  • Ajukan pertanyaan singkat. Jika terjadi kesalahan, lihat kode dan Request ID, lalu cocokkan dengan halaman Kesalahan dan batas.
  • 404 segera setelah konfigurasi hampir selalu berarti alamat salah: ada tambahan atau kekurangan /v1.
  • 402 — saldo tidak cukup untuk ditahan. Agen menahan saldo lebih besar daripada chat: alasannya.

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

Masih ada pertanyaan? Kirim Request ID dan penjelasannya — kami akan membantu.Hubungi dukungan