Bot do Telegram
MarkdownBots · OpenAI Chat
Guia completo
| Formato | Onde configurar |
|---|---|
| OpenAI Chat | Os frameworks Telegram não têm uma camada LLM própria: o processador de mensagens chama o OpenAI SDK com base_url do Ailoot (ou Anthropic SDK com base_url sem /v1) |
Configuração
Copie a configuração e substitua sk-... pela sua chave da área pessoal Ailoot. É preferível guardar a chave na variável de ambiente AILOOT_API_KEY, se a aplicação o permitir.
Antes de iniciar, consulte GET /v1/models com a sua chave Ailoot. Escolha um ID exato de modelo cujos métodos incluam POST /v1/chat/completions e use-o na configuração. Para agentes, verifique também as ferramentas e funcionalidades necessárias à sua versão do cliente.
Guarde o código Python como ailoot-telegram-bot.py. Instale as dependências, defina as duas variáveis de ambiente e execute o ficheiro. Envie Hello ao bot e verifique a resposta de texto. Se ocorrer um erro, guarde o Request ID e verifique o resultado original antes de outra geração.
python3 -m pip install "aiogram>=3,<4" openaiailoot-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.pyExemplo de modelo: claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash. Escolha qualquer outro modelo no catálogo — verifique se suporta o formato necessário.
O que deve saber
Verificação
- Para o formato OpenAI, o endereço é
https://api.ailoot.ai/v1(ou o caminho completo, se a aplicação pedir o endereço completo). - Faça uma pergunta curta. Se receber um erro, consulte o código e o Request ID e compare com a página Erros e limites.
- Um 404 logo após a configuração quase sempre indica um endereço incorreto: um segmento a mais ou em falta,
/v1. - 402 — o saldo não chega para a reserva. Os agentes reservam mais do que um chat: porquê.
Documentação da aplicação: https://github.com/openai/openai-python