ドキュメント
自動化

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と状況の説明をお送りください。調査をお手伝いします。サポートに問い合わせる