التوثيق
الأتمتة

بوت Telegram

Markdown

بوتات · OpenAI Chat

الدليل الكامل
الصيغةمكان الإعداد
OpenAI Chatلا تتضمن أطر Telegram طبقة LLM خاصة؛ يستدعي معالج الرسائل OpenAI SDK مع base_url لـAiloot (أوAnthropic SDK بعنوان base_url دون /v1)

الإعداد

انسخ الإعداد واستبدل sk-... بمفتاحك من لوحة حساب Ailoot. يُفضّل حفظ المفتاح في متغير البيئة AILOOT_API_KEYإذا كان التطبيق يدعم ذلك.

قبل البدء، استدعِ GET /v1/models بمفتاح Ailoot الخاص بك. اختر معرّف نموذج دقيقًا تتضمن طرقه POST /v1/chat/completions واستخدمه في الإعدادات. للوكلاء، تحقّق أيضًا من دعم الأدوات والميزات المطلوبة لإصدار العميل لديك.

احفظ كود 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 ووصفاً للمشكلة وسنساعدك على فهمها.مراسلة الدعم