{"id":476567,"date":"2026-04-19T15:15:44","date_gmt":"2026-04-19T15:15:44","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=476567"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=476567","title":{"rendered":"\u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f Google Gemini API \u0432 \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439 Telegram-\u0431\u043e\u0442 \u043d\u0430 aiogram 3.x \u0438 Python"},"content":{"rendered":"
\n

\u0412 \u043f\u0440\u043e\u0448\u043b\u0443\u044e \u043f\u044f\u0442\u043d\u0438\u0446\u0443, \u0440\u043e\u0432\u043d\u043e \u0432 18:47, \u043a\u043e\u0433\u0434\u0430 \u044f \u0443\u0436\u0435 \u043c\u044b\u0441\u043b\u0435\u043d\u043d\u043e \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u043b \u0432\u0435\u043b\u0438\u043a\u043e\u043b\u0435\u043f\u043d\u044b\u0439, \u043d\u0430\u043f\u043e\u043b\u043d\u0435\u043d\u043d\u044b\u0439 \u0432\u0438\u0442\u0430\u043c\u0438\u043d\u0430\u043c\u0438, \u043d\u0430\u043f\u0438\u0442\u043e\u043a, \u043c\u043d\u0435 \u043f\u0440\u0438\u043b\u0435\u0442\u0435\u043b\u043e \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u043e\u0442 \u0442\u0438\u043c\u043b\u0438\u0434\u0430: \u00ab\u0411\u043e\u0442 \u043b\u0435\u0436\u0438\u0442, \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0438 \u0436\u0430\u043b\u0443\u044e\u0442\u0441\u044f, Gemini API \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 429\u00bb. \u041d\u0430\u0448 \u043a\u043e\u0440\u043f\u043e\u0440\u0430\u0442\u0438\u0432\u043d\u044b\u0439 Telegram-\u0431\u043e\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u043b \u043f\u043e\u043c\u043e\u0433\u0430\u0442\u044c \u0441\u0430\u043f\u043f\u043e\u0440\u0442\u0443 \u043e\u0442\u0432\u0435\u0447\u0430\u0442\u044c \u043d\u0430 \u0442\u0438\u043a\u0435\u0442\u044b, \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u0441\u0442\u0430\u043b \u043a\u043e\u043b\u043e\u043c. \u041f\u0440\u0438\u0447\u0438\u043d\u0430 \u043e\u043a\u0430\u0437\u0430\u043b\u0430\u0441\u044c \u0434\u043e \u0431\u0430\u043d\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u0438 \u043f\u0440\u043e\u0441\u0442\u043e\u0439: \u043c\u044b \u043d\u0435 \u0443\u0447\u043b\u0438 rate limiting \u0438 \u0434\u0443\u043c\u0430\u043b\u0438, \u0447\u0442\u043e 50 RPM (\u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0432 \u043c\u0438\u043d\u0443\u0442\u0443) \u043d\u0430 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u043c \u0442\u0430\u0440\u0438\u0444\u0435 \u2014 \u044d\u0442\u043e \u00ab\u0431\u0435\u0441\u043a\u043e\u043d\u0435\u0447\u043d\u043e \u043c\u043d\u043e\u0433\u043e\u00bb. \u0421 \u0442\u0435\u0445 \u043f\u043e\u0440 \u043c\u044b \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u043b\u0438 \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0443, \u0434\u043e\u0431\u0430\u0432\u0438\u043b\u0438 \u043e\u0447\u0435\u0440\u0435\u0434\u0438, \u043a\u044d\u0448\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u0438 middleware \u0434\u043b\u044f retry. \u0412 \u044d\u0442\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u0440\u0430\u0437\u0431\u0435\u0440\u0443, \u043a\u0430\u043a \u0441 \u043d\u0443\u043b\u044f \u043f\u043e\u0434\u0440\u0443\u0436\u0438\u0442\u044c Gemini API \u0441 Telegram-\u0431\u043e\u0442\u043e\u043c \u043d\u0430 aiogram 3.x, \u043d\u0435 \u043d\u0430\u0441\u0442\u0443\u043f\u0430\u044f \u043d\u0430 \u0442\u0435 \u0436\u0435 \u0433\u0440\u0430\u0431\u043b\u0438.<\/p>\n

\u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430: \u0447\u0442\u043e \u0438 \u0437\u0430\u0447\u0435\u043c<\/h3>\n

\u041a\u043b\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043a\u0430\u044f \u0441\u0445\u0435\u043c\u0430 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:
[Telegram User] \u2192 [aiogram Bot] \u2192 [Gemini API]
\u2193
[Response Queue \/ Cache]<\/p>\n

\u041d\u043e \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c \u043f\u0440\u043e\u0434\u0430\u043a\u0448\u0435\u043d\u0435 \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u043e\u0431\u0432\u044f\u0437\u043a\u0430: <\/p>\n

[Telegram] \u2192 [aiogram] \u2192 [asyncio Queue] \u2192 [Rate Limiter] \u2192 [Gemini API]
\u2191 \u2193
[Response Cache] \u2190\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 [Streaming Handler]<\/p>\n

\u041f\u043e\u0447\u0435\u043c\u0443 \u044d\u0442\u043e \u0432\u0430\u0436\u043d\u043e? Gemini API \u0438\u043c\u0435\u0435\u0442 \u0436\u0451\u0441\u0442\u043a\u0438\u0435 \u043b\u0438\u043c\u0438\u0442\u044b:
1.\u0411\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u0442\u0430\u0440\u0438\u0444: 5\u201315 RPM<\/strong> \u0432 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u043e\u0442 \u043c\u043e\u0434\u0435\u043b\u0438
2.\u041e\u0442\u0432\u0435\u0442\u044b \u043c\u043e\u0433\u0443\u0442 \u0438\u0434\u0442\u0438 \u0434\u043e 10\u201315 \u0441\u0435\u043a\u0443\u043d\u0434<\/strong> \u043d\u0430 \u0434\u043b\u0438\u043d\u043d\u044b\u0445 \u043f\u0440\u043e\u043c\u043f\u0442\u0430\u0445.
3.\u041f\u043b\u0430\u0442\u043d\u044b\u0439: \u0434\u043e 60 RPM<\/strong> \u0434\u043b\u044f Gemini 2.0 Flash
\u0415\u0441\u043b\u0438 \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u044b\u0437\u044b\u0432\u0430\u0442\u044c await client.models.generate_content()<\/code> \u0432\u043d\u0443\u0442\u0440\u0438 \u0445\u0435\u043d\u0434\u043b\u0435\u0440\u0430 \u2014 \u0432\u044b \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u0435 \u0438\u0432\u0435\u043d\u0442-\u043b\u0443\u043f aiogram \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 \u0442\u0430\u0439\u043c\u0430\u0443\u0442\u044b \u043e\u0442 Telegram. \u0410\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u043e\u0441\u0442\u044c aiogram \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u0441\u043f\u0430\u0441\u0430\u0435\u0442 \u2014 \u0431\u043b\u043e\u043a\u0438\u0440\u0443\u044e\u0449\u0438\u0439 \u0432\u044b\u0437\u043e\u0432 \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0431\u043b\u043e\u043a\u0438\u0440\u0443\u044e\u0449\u0438\u043c.<\/p>\n

\u0428\u0430\u0433 1. \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 Gemini API<\/h3>\n

\u0421\u0442\u0430\u0432\u0438\u043c \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443 Google GenAI SDK (\u043e\u043d\u0430 \u0436\u0435 google-genai<\/code>):<\/p>\n

pip install google-genai aiogram python-dotenv<\/code>
<\/a><\/div><\/pre>\n
\n\u0421\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442<\/summary>\n
\n
\u0412\u0430\u0436\u043d\u043e:<\/strong> \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 google-generativeai<\/code> \u0443\u0441\u0442\u0430\u0440\u0435\u043b\u0430 \u0438 \u0441 \u043c\u0430\u044f 2025 \u0433\u043e\u0434\u0430 \u043d\u0435 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044f. \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 \u0438\u043c\u0435\u043d\u043d\u043e google-genai<\/code> <\/p>\n<\/div>\n<\/details>\n
\u0421\u043e\u0437\u0434\u0430\u0451\u043c .env<\/code> \u0444\u0430\u0439\u043b:<\/p>\n
GEMINI_API_KEY=your-api-key-hereTELEGRAM_BOT_TOKEN=your-bot-token<\/code>
<\/a><\/div><\/pre>\n
\u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c API-\u043a\u043b\u044e\u0447 \u043c\u043e\u0436\u043d\u043e \u0432 Google AI Studio<\/a> \u2192 API Keys \u2192 Create API Key.<\/p>\n
\u0411\u0430\u0437\u043e\u0432\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442: <\/p>\n
# gemini_client.pyimport osfrom google import genaifrom google.genai import typesclass GeminiClient:    def __init__(self, model: str = \"gemini-3-flash-preview\"):        self.client = genai.Client()  # \u043a\u043b\u044e\u0447 \u0431\u0435\u0440\u0451\u0442\u0441\u044f \u0438\u0437 GEMINI_API_KEY        self.model = model        async def generate(self, prompt: str) -> str:        # \u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: \u044d\u0442\u043e \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439 \u0432\u044b\u0437\u043e\u0432!        # await \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u043f\u043e\u043c\u043e\u0436\u0435\u0442, \u043d\u0443\u0436\u0435\u043d asyncio.to_thread        response = self.client.models.generate_content(            model=self.model,            contents=prompt        )        return response.text<\/code>
<\/a><\/div><\/pre>\n
\n\u0421\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442<\/summary>\n
\n
\u0412\u0430\u0436\u043d\u043e\u0435 \u0437\u0430\u043c\u0435\u0447\u0430\u043d\u0438\u0435:<\/strong> \u043a\u043b\u0438\u0435\u043d\u0442 google-genai<\/code> \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439! \u0412 \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u043e\u043c aiogram \u0435\u0433\u043e \u0432\u044b\u0437\u043e\u0432\u044b \u0431\u0443\u0434\u0443\u0442 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u0432\u0435\u043d\u0442-\u043b\u0443\u043f. <\/p>\n<\/div>\n<\/details>\n
\u0428\u0430\u0433 2. \u0410\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u0430\u044f \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u0447\u0435\u0440\u0435\u0437 asyncio.to_thread<\/h3>\n
\u0427\u0442\u043e\u0431\u044b \u043d\u0435 \u0432\u0435\u0448\u0430\u0442\u044c \u0432\u0435\u0441\u044c \u0431\u043e\u0442 \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 \u043a Gemini, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c asyncio.to<\/code><\/a>_thread<\/code>:<\/p>\n
# async_gemini.pyimport asynciofrom google import genaiclass AsyncGeminiClient:    def __init__(self, model: str = \"gemini-3-flash-preview\"):        self.client = genai.Client()        self.model = model        async def generate(self, prompt: str) -> str:        loop = asyncio.get_event_loop()        # \u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u043c \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439 \u0432\u044b\u0437\u043e\u0432 \u0432 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u043c \u043f\u043e\u0442\u043e\u043a\u0435        response = await loop.run_in_executor(            None,  # \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c \u0434\u0435\u0444\u043e\u043b\u0442\u043d\u044b\u0439 ThreadPoolExecutor            self._sync_generate,            prompt        )        return response        def _sync_generate(self, prompt: str) -> str:        response = self.client.models.generate_content(            model=self.model,            contents=prompt        )        return response.text<\/code>
<\/a><\/div><\/pre>\n
\n\u0421\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442<\/summary>\n
\n
\u042d\u0442\u043e \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u043e \u0436\u0438\u0437\u043d\u0435\u0441\u043f\u043e\u0441\u043e\u0431\u043d\u044b\u0439 \u0432\u0430\u0440\u0438\u0430\u043d\u0442. \u0414\u043b\u044f \u043f\u0440\u043e\u0434\u0430\u043a\u0448\u0435\u043d\u0430 \u043f\u043e\u043d\u0430\u0434\u043e\u0431\u0438\u0442\u0441\u044f \u0435\u0449\u0451 \u043e\u0447\u0435\u0440\u0435\u0434\u044c \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432. <\/p>\n<\/div>\n<\/details>\n
\u0428\u0430\u0433 3. \u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f \u0441 aiogram<\/h3>\n
\u0411\u0430\u0437\u043e\u0432\u044b\u0439 \u0445\u0435\u043d\u0434\u043b\u0435\u0440 \u0434\u043b\u044f aiogram 3.x: <\/p>\n
# bot.pyimport asyncioimport loggingfrom aiogram import Bot, Dispatcher, Router, typesfrom aiogram.filters import Commandfrom aiogram.enums import ParseModefrom dotenv import load_dotenvfrom async_gemini import AsyncGeminiClientload_dotenv()logging.basicConfig(level=logging.INFO)router = Router()gemini = AsyncGeminiClient()@router.message(Command(\"start\"))async def cmd_start(message: types.Message):    await message.answer(        \"\u041f\u0440\u0438\u0432\u0435\u0442! \u042f \u0431\u043e\u0442 \u0441 Gemini API. \u041f\u0440\u043e\u0441\u0442\u043e \u043d\u0430\u043f\u0438\u0448\u0438 \u043c\u043d\u0435 \u0432\u043e\u043f\u0440\u043e\u0441, \u0438 \u044f \u043e\u0442\u0432\u0435\u0447\u0443.\"    )@router.message()async def handle_message(message: types.Message):    # \u041f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c, \u0447\u0442\u043e \u0431\u043e\u0442 \"\u043f\u0435\u0447\u0430\u0442\u0430\u0435\u0442\"    await message.bot.send_chat_action(        chat_id=message.chat.id,        action=\"typing\"    )        try:        response = await gemini.generate(message.text)        # Telegram \u0438\u043c\u0435\u0435\u0442 \u043b\u0438\u043c\u0438\u0442 4096 \u0441\u0438\u043c\u0432\u043e\u043b\u043e\u0432 \u043d\u0430 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435        if len(response) > 4000:            # \u0420\u0430\u0437\u0431\u0438\u0432\u0430\u0435\u043c \u043d\u0430 \u0447\u0430\u0441\u0442\u0438            for i in range(0, len(response), 4000):                await message.answer(response[i:i+4000])        else:            await message.answer(response)    except Exception as e:        logging.error(f\"Gemini error: {e}\")        await message.answer(            \"\u0427\u0442\u043e-\u0442\u043e \u043f\u043e\u0448\u043b\u043e \u043d\u0435 \u0442\u0430\u043a. \u041f\u043e\u043f\u0440\u043e\u0431\u0443\u0439\u0442\u0435 \u043f\u043e\u0437\u0436\u0435 \u0438\u043b\u0438 \u0441\u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u0443\u0439\u0442\u0435 \u0437\u0430\u043f\u0440\u043e\u0441 \u0438\u043d\u0430\u0447\u0435.\"        )async def main():    bot = Bot(token=os.getenv(\"TELEGRAM_BOT_TOKEN\"))    dp = Dispatcher()    dp.include_router(router)        await dp.start_polling(bot)if __name__ == \"__main__\":    asyncio.run(main())<\/code>
<\/a><\/div><\/pre>\n
\u0428\u0430\u0433 4. \u0424\u0443\u043d\u043a\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439 \u0432\u044b\u0437\u043e\u0432 (Function Calling) \u0434\u043b\u044f \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0435\u0439<\/h3>\n
Gemini \u0443\u043c\u0435\u0435\u0442 \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0442\u0435\u043a\u0441\u0442, \u043d\u043e \u0438 \u0432\u044b\u0437\u044b\u0432\u0430\u0442\u044c \u0432\u043d\u0435\u0448\u043d\u0438\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u0438. \u042d\u0442\u043e \u043f\u043e\u043b\u0435\u0437\u043d\u043e, \u0435\u0441\u043b\u0438 \u0431\u043e\u0442 \u0434\u043e\u043b\u0436\u0435\u043d \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u043c\u0438 \u0434\u0430\u043d\u043d\u044b\u043c\u0438: \u0431\u0440\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0432\u0441\u0442\u0440\u0435\u0447\u0438, \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u0441\u0442\u0430\u0442\u0443\u0441 \u0437\u0430\u043a\u0430\u0437\u0430, \u0438\u0441\u043a\u0430\u0442\u044c \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u0432 \u0431\u0430\u0437\u0435. \u041f\u0440\u0438\u043c\u0435\u0440 \u0434\u043b\u044f \u043f\u043b\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0432\u0441\u0442\u0440\u0435\u0447:<\/p>\n
# function_calling.pyfrom google import genaifrom google.genai import types# \u041e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u043c \u0444\u0443\u043d\u043a\u0446\u0438\u044e, \u043a\u043e\u0442\u043e\u0440\u0443\u044e Gemini \u043c\u043e\u0436\u0435\u0442 \u0432\u044b\u0437\u0432\u0430\u0442\u044cschedule_meeting_function = {    \"name\": \"schedule_meeting\",    \"description\": \"\u0421\u043e\u0437\u0434\u0430\u0451\u0442 \u0432\u0441\u0442\u0440\u0435\u0447\u0443 \u0441 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u043c\u0438 \u0443\u0447\u0430\u0441\u0442\u043d\u0438\u043a\u0430\u043c\u0438\",    \"parameters\": {        \"type\": \"object\",        \"properties\": {            \"attendees\": {                \"type\": \"array\",                \"items\": {\"type\": \"string\"},                \"description\": \"\u0421\u043f\u0438\u0441\u043e\u043a email \u0443\u0447\u0430\u0441\u0442\u043d\u0438\u043a\u043e\u0432\",            },            \"date\": {                \"type\": \"string\",                \"description\": \"\u0414\u0430\u0442\u0430 \u0432\u0441\u0442\u0440\u0435\u0447\u0438 (\u0413\u0413\u0413\u0413-\u041c\u041c-\u0414\u0414)\",            },            \"time\": {                \"type\": \"string\",                \"description\": \"\u0412\u0440\u0435\u043c\u044f \u0432\u0441\u0442\u0440\u0435\u0447\u0438 (\u0427\u0427:\u041c\u041c)\",            },            \"topic\": {                \"type\": \"string\",                \"description\": \"\u0422\u0435\u043c\u0430 \u0432\u0441\u0442\u0440\u0435\u0447\u0438\",            },        },        \"required\": [\"attendees\", \"date\", \"time\", \"topic\"],    },}# \u0420\u0435\u0430\u043b\u044c\u043d\u0430\u044f \u0444\u0443\u043d\u043a\u0446\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u0443\u044e \u043c\u044b \u0431\u0443\u0434\u0435\u043c \u0432\u044b\u0437\u044b\u0432\u0430\u0442\u044cdef schedule_meeting(attendees: list, date: str, time: str, topic: str):    # \u0417\u0434\u0435\u0441\u044c \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0432\u044b\u0437\u043e\u0432 Google Calendar API, \u0411\u0414 \u0438 \u0442.\u0434.    return f\"\u0412\u0441\u0442\u0440\u0435\u0447\u0430 '{topic}' \u0437\u0430\u043f\u043b\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0430 \u043d\u0430 {date} \u0432 {time} \u0441 {', '.join(attendees)}\"# \u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f \u0441 Geminiclient = genai.Client()tools = types.Tool(function_declarations=[schedule_meeting_function])config = types.GenerateContentConfig(tools=[tools])response = client.models.generate_content(    model=\"gemini-3-flash-preview\",    contents=\"\u0417\u0430\u043f\u043b\u0430\u043d\u0438\u0440\u0443\u0439 \u0432\u0441\u0442\u0440\u0435\u0447\u0443 \u0441 bob@company.com \u0438 alice@company.com \u043d\u0430 15.04.2026 \u0432 14:00 \u043f\u043e \u043f\u043e\u0432\u043e\u0434\u0443 \u0437\u0430\u043f\u0443\u0441\u043a\u0430 \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u0430\",    config=config,)if response.candidates[0].content.parts[0].function_call:    fc = response.candidates[0].content.parts[0].function_call    print(f\"Gemini \u0445\u043e\u0447\u0435\u0442 \u0432\u044b\u0437\u0432\u0430\u0442\u044c: {fc.name}\")    print(f\"\u0421 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u0430\u043c\u0438: {fc.args}\")    # \u0412\u044b\u0437\u044b\u0432\u0430\u0435\u043c \u043d\u0430\u0448\u0443 \u0444\u0443\u043d\u043a\u0446\u0438\u044e \u0441 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u0430\u043c\u0438 \u043e\u0442 Gemini    result = schedule_meeting(**fc.args)    print(result)<\/code>
<\/a><\/div><\/pre>\n
\u042d\u0442\u043e \u043c\u043e\u0449\u043d\u044b\u0439 \u043f\u0430\u0442\u0442\u0435\u0440\u043d, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043f\u0440\u043e\u0441\u0442\u043e\u0433\u043e \u0447\u0430\u0442-\u0431\u043e\u0442\u0430 \u0432 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0435\u0433\u043e \u0430\u0433\u0435\u043d\u0442\u0430. <\/p>\n
\u0428\u0430\u0433 5. \u041a\u044d\u0448\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u043e\u0442\u0432\u0435\u0442\u043e\u0432 (\u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u043f\u043b\u0430\u0442\u0438\u0442\u044c \u0434\u0432\u0430\u0436\u0434\u044b)<\/h3>\n
Gemini API \u0442\u0430\u0440\u0438\u0444\u0438\u0446\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043f\u043e \u0442\u043e\u043a\u0435\u043d\u0430\u043c. \u0415\u0441\u043b\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0438 \u0447\u0430\u0441\u0442\u043e \u0437\u0430\u0434\u0430\u044e\u0442 \u043e\u0434\u043d\u0438 \u0438 \u0442\u0435 \u0436\u0435 \u0432\u043e\u043f\u0440\u043e\u0441\u044b (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u00ab\u043a\u0430\u043a \u0441\u0431\u0440\u043e\u0441\u0438\u0442\u044c \u043f\u0430\u0440\u043e\u043b\u044c\u00bb), \u0432\u044b \u0431\u0443\u0434\u0435\u0442\u0435 \u043f\u043b\u0430\u0442\u0438\u0442\u044c \u0437\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441. \u0420\u0435\u0448\u0435\u043d\u0438\u0435 \u2014 \u043f\u0440\u043e\u0441\u0442\u043e\u0439 in-memory \u043a\u044d\u0448: <\/p>\n
# cache.pyimport hashlibfrom datetime import datetime, timedeltafrom typing import Optionalclass SimpleCache:    def __init__(self, ttl_seconds: int = 3600):        self._cache = {}        self._ttl = ttl_seconds        def get(self, key: str) -> Optional[str]:        if key in self._cache:            value, timestamp = self._cache[key]            if datetime.now() - timestamp < timedelta(seconds=self._ttl):                return value            else:                del self._cache[key]        return None        def set(self, key: str, value: str):        self._cache[key] = (value, datetime.now())        @staticmethod    def hash_prompt(prompt: str) -> str:        return hashlib.md5(prompt.lower().strip().encode()).hexdigest()<\/code>
<\/a><\/div><\/pre>\n
\u0412 \u0445\u0435\u043d\u0434\u043b\u0435\u0440\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c: <\/p>\n
cache = SimpleCache(ttl_seconds=7200)  # 2 \u0447\u0430\u0441\u0430@router.message()async def handle_message(message: types.Message):    prompt_hash = cache.hash_prompt(message.text)    cached = cache.get(prompt_hash)        if cached:        await message.answer(cached)        return        response = await gemini.generate(message.text)    cache.set(prompt_hash, response)    await message.answer(response)<\/code>
<\/a><\/div><\/pre>\n
\u0413\u0440\u0430\u0431\u043b\u0438 (\u0442\u043e, \u043e \u0447\u0451\u043c \u043d\u0435 \u043f\u0438\u0448\u0443\u0442 \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438)<\/h3>\n
\u0413\u0440\u0430\u0431\u043b\u0438 \u21161: 429 \u043e\u0448\u0438\u0431\u043a\u0430 \u0432 \u043f\u044f\u0442\u043d\u0438\u0446\u0443 \u0432\u0435\u0447\u0435\u0440\u043e\u043c<\/h4>\n
\u0421\u0430\u043c\u0430\u044f \u0447\u0430\u0441\u0442\u0430\u044f \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430 \u2014 RESOURCE_EXHAUSTED (429)<\/code>. \u041f\u0440\u0438\u0447\u0438\u043d\u044b:<\/p>\n
    \n
  1. \n
    RPM-\u043b\u0438\u043c\u0438\u0442.<\/strong> \u0411\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u0442\u0430\u0440\u0438\u0444 \u0434\u0430\u0451\u0442 5 RPM, \u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u2014 \u0434\u043e 60 RPM<\/p>\n<\/li>\n
  2. \n
    TPM-\u043b\u0438\u043c\u0438\u0442.<\/strong> \u041e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0435 \u043d\u0430 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0442\u043e\u043a\u0435\u043d\u043e\u0432 \u0432 \u043c\u0438\u043d\u0443\u0442\u0443 (1M \u0434\u043b\u044f \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u0433\u043e \u0442\u0430\u0440\u0438\u0444\u0430).<\/p>\n<\/li>\n
  3. \n
    RPD-\u043b\u0438\u043c\u0438\u0442.<\/strong> \u041e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0435 \u043d\u0430 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0432 \u0434\u0435\u043d\u044c (25\u20131500 \u0432 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u043e\u0442 \u043c\u043e\u0434\u0435\u043b\u0438).<\/p>\n<\/li>\n<\/ol>\n
    \u0420\u0435\u0448\u0435\u043d\u0438\u0435:<\/strong> \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 rate limiter \u043d\u0430 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 \u0431\u043e\u0442\u0430:<\/p>\n
    # rate_limiter.pyimport asyncioimport timeclass AsyncRateLimiter:    def __init__(self, max_requests: int, time_window: int = 60):        self.max_requests = max_requests        self.time_window = time_window        self.requests = []        self._lock = asyncio.Lock()        async def acquire(self):        async with self._lock:            now = time.time()            # \u0423\u0434\u0430\u043b\u044f\u0435\u043c \u0441\u0442\u0430\u0440\u044b\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u044b            self.requests = [t for t in self.requests if now - t < self.time_window]                        if len(self.requests) >= self.max_requests:                sleep_time = self.time_window - (now - self.requests[0])                await asyncio.sleep(sleep_time + 0.1)                return await self.acquire()                        self.requests.append(now)<\/code>
    <\/a><\/div><\/pre>\n
    \u0413\u0440\u0430\u0431\u043b\u0438 \u21162: \u0422\u0430\u0439\u043c\u0430\u0443\u0442\u044b \u043e\u0442 Telegram<\/h4>\n
    Telegram \u0436\u0434\u0451\u0442 \u043e\u0442\u0432\u0435\u0442 \u043e\u0442 \u0431\u043e\u0442\u0430 10 \u0441\u0435\u043a\u0443\u043d\u0434<\/strong>. \u0415\u0441\u043b\u0438 Gemini \u0434\u0443\u043c\u0430\u0435\u0442 \u0434\u043e\u043b\u044c\u0448\u0435, \u0432\u044b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 \u0442\u0430\u0439\u043c\u0430\u0443\u0442 \u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u0443\u0432\u0438\u0434\u0438\u0442 \u043e\u0448\u0438\u0431\u043a\u0443. \u0420\u0435\u0448\u0435\u043d\u0438\u0435 \u2014 \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u043f\u0440\u043e\u043c\u0435\u0436\u0443\u0442\u043e\u0447\u043d\u044b\u0435 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f \u0438\u043b\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c streaming<\/strong>:<\/p>\n
    # streaming_example.pyasync def generate_stream(prompt: str):    for chunk in client.models.generate_content_stream(        model=\"gemini-3-flash-preview\",        contents=prompt    ):        yield chunk.text<\/code>
    <\/a><\/div><\/pre>\n
    \u0412 aiogram \u043c\u043e\u0436\u043d\u043e \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c \u043e\u0434\u043d\u043e \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435: <\/p>\n
    sent = await message.answer(\"\u0414\u0443\u043c\u0430\u044e...\")full_response = \"\"async for chunk in gemini.generate_stream(message.text):    full_response += chunk    if len(full_response) % 100 == 0:  # \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u043c \u043a\u0430\u0436\u0434\u044b\u0435 100 \u0441\u0438\u043c\u0432\u043e\u043b\u043e\u0432        try:            await sent.edit_text(full_response)        except:            passawait sent.edit_text(full_response)<\/code>
    <\/a><\/div><\/pre>\n
    \u0413\u0440\u0430\u0431\u043b\u0438 \u21163: \u041c\u043e\u0434\u0435\u043b\u0438 \u0443\u0441\u0442\u0430\u0440\u0435\u0432\u0430\u044e\u0442 \u0431\u044b\u0441\u0442\u0440\u0435\u0435, \u0447\u0435\u043c \u0432\u044b \u0447\u0438\u0442\u0430\u0435\u0442\u0435 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e<\/h4>\n
    Gemini \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043a\u0430\u0436\u0434\u044b\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043c\u0435\u0441\u044f\u0446\u0435\u0432. \u041d\u0430 \u043c\u043e\u043c\u0435\u043d\u0442 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u044f \u0441\u0442\u0430\u0442\u044c\u0438 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u044b:
    gemini-3-flash-preview \u2014 \u0431\u044b\u0441\u0442\u0440\u0430\u044f \u0438 \u0434\u0435\u0448\u0451\u0432\u0430\u044f \u043c\u043e\u0434\u0435\u043b\u044c
    gemini-3.1-pro-preview \u2014 \u043c\u043e\u0449\u043d\u0430\u044f, \u043d\u043e \u0434\u043e\u0440\u043e\u0433\u0430\u044f ($2.00 \u0437\u0430 1M \u0432\u0445\u043e\u0434\u043d\u044b\u0445 \u0442\u043e\u043a\u0435\u043d\u043e\u0432, $12.00 \u0437\u0430 1M \u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0445)
    \u0421 \u043c\u0430\u0440\u0442\u0430 2026 \u0433\u043e\u0434\u0430 Pro-\u043c\u043e\u0434\u0435\u043b\u0438 \u043d\u0435\u0434\u043e\u0441\u0442\u0443\u043f\u043d\u044b \u043d\u0430 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u043c \u0442\u0430\u0440\u0438\u0444\u0435<\/strong> \u2014 \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u043b\u0430\u0442\u043d\u0430\u044f \u043f\u043e\u0434\u043f\u0438\u0441\u043a\u0430<\/p>\n
    \u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435<\/h3>\n
    \u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f Gemini API \u0432 Telegram-\u0431\u043e\u0442\u0430 \u2014 \u0437\u0430\u0434\u0430\u0447\u0430 \u043d\u0430 \u043f\u0430\u0440\u0443 \u0447\u0430\u0441\u043e\u0432, \u0435\u0441\u043b\u0438 \u0437\u043d\u0430\u0442\u044c \u0432\u0441\u0435 \u043f\u043e\u0434\u0432\u043e\u0434\u043d\u044b\u0435 \u043a\u0430\u043c\u043d\u0438. \u041a\u043b\u044e\u0447\u0435\u0432\u044b\u0435 \u0432\u044b\u0432\u043e\u0434\u044b:<\/p>\n
      \n
    1. \n
      \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 asyncio.to_thread<\/code> \u0438\u043b\u0438 \u043e\u0447\u0435\u0440\u0435\u0434\u0438, \u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u0432\u0435\u043d\u0442-\u043b\u0443\u043f aiogram.<\/p>\n<\/li>\n
    2. \n
      \u0412\u043d\u0435\u0434\u0440\u044f\u0439\u0442\u0435 rate limiter \u0438 retry-\u043b\u043e\u0433\u0438\u043a\u0443 \u0434\u043e \u0442\u043e\u0433\u043e, \u043a\u0430\u043a \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 429 \u0432 \u043f\u0440\u043e\u0434\u0430\u043a\u0448\u0435\u043d\u0435.<\/p>\n<\/li>\n
    3. \n
      \u041a\u044d\u0448\u0438\u0440\u0443\u0439\u0442\u0435 \u0447\u0430\u0441\u0442\u044b\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u044b \u2014 \u044d\u043a\u043e\u043d\u043e\u043c\u0438\u044f \u043d\u0430 \u0442\u043e\u043a\u0435\u043d\u0430\u0445 \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0439.<\/p>\n<\/li>\n
    4. \n
      Function Calling \u2014 \u0432\u0430\u0448 \u0434\u0440\u0443\u0433, \u0435\u0441\u043b\u0438 \u0431\u043e\u0442 \u0434\u043e\u043b\u0436\u0435\u043d \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u0441 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u043c\u0438 \u0441\u0435\u0440\u0432\u0438\u0441\u0430\u043c\u0438.<\/p>\n<\/li>\n<\/ol>\n
      \u0427\u0442\u043e \u0431\u044b \u0432\u044b \u0434\u043e\u0431\u0430\u0432\u0438\u043b\u0438?<\/strong> \u0421\u0442\u0430\u043b\u043a\u0438\u0432\u0430\u043b\u0438\u0441\u044c \u043b\u0438 \u0432\u044b \u0441 \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430\u043c\u0438 \u043f\u0440\u0438 \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u0438 LLM \u0432 \u0431\u043e\u0442\u043e\u0432? \u041c\u043e\u0436\u0435\u0442, \u0443 \u043a\u043e\u0433\u043e-\u0442\u043e \u0435\u0441\u0442\u044c \u043e\u043f\u044b\u0442 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f Gemini API \u0432 \u0432\u044b\u0441\u043e\u043a\u043e\u043d\u0430\u0433\u0440\u0443\u0436\u0435\u043d\u043d\u044b\u0445 \u043f\u0440\u043e\u0435\u043a\u0442\u0430\u0445? \u0414\u0430\u0432\u0430\u0439\u0442\u0435 \u043e\u0431\u0441\u0443\u0434\u0438\u043c \u0432 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445 \u2014 \u043e\u0441\u043e\u0431\u0435\u043d\u043d\u043e \u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e \u0443\u0441\u043b\u044b\u0448\u0430\u0442\u044c \u043f\u0440\u043e \u0432\u0430\u0448\u0438 \u043a\u0435\u0439\u0441\u044b \u0441 429 \u0438 \u0442\u0430\u0439\u043c\u0430\u0443\u0442\u0430\u043c\u0438.<\/p>\n<\/div>\n
      \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 https:\/\/habr.com\/ru\/articles\/1025300\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
      \u0412 \u043f\u0440\u043e\u0448\u043b\u0443\u044e \u043f\u044f\u0442\u043d\u0438\u0446\u0443, \u0440\u043e\u0432\u043d\u043e \u0432 18:47, \u043a\u043e\u0433\u0434\u0430 \u044f \u0443\u0436\u0435 \u043c\u044b\u0441\u043b\u0435\u043d\u043d\u043e \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u043b \u0432\u0435\u043b\u0438\u043a\u043e\u043b\u0435\u043f\u043d\u044b\u0439, \u043d\u0430\u043f\u043e\u043b\u043d\u0435\u043d\u043d\u044b\u0439 \u0432\u0438\u0442\u0430\u043c\u0438\u043d\u0430\u043c\u0438, \u043d\u0430\u043f\u0438\u0442\u043e\u043a, \u043c\u043d\u0435 \u043f\u0440\u0438\u043b\u0435\u0442\u0435\u043b\u043e \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u043e\u0442 \u0442\u0438\u043c\u043b\u0438\u0434\u0430: \u00ab\u0411\u043e\u0442 \u043b\u0435\u0436\u0438\u0442, \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0438 \u0436\u0430\u043b\u0443\u044e\u0442\u0441\u044f, Gemini API \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 429\u00bb. \u041d\u0430\u0448 \u043a\u043e\u0440\u043f\u043e\u0440\u0430\u0442\u0438\u0432\u043d\u044b\u0439 Telegram-\u0431\u043e\u0442, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u043b \u043f\u043e\u043c\u043e\u0433\u0430\u0442\u044c \u0441\u0430\u043f\u043f\u043e\u0440\u0442\u0443 \u043e\u0442\u0432\u0435\u0447\u0430\u0442\u044c \u043d\u0430 \u0442\u0438\u043a\u0435\u0442\u044b, \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u0441\u0442\u0430\u043b \u043a\u043e\u043b\u043e\u043c. \u041f\u0440\u0438\u0447\u0438\u043d\u0430 \u043e\u043a\u0430\u0437\u0430\u043b\u0430\u0441\u044c \u0434\u043e \u0431\u0430\u043d\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u0438 \u043f\u0440\u043e\u0441\u0442\u043e\u0439: \u043c\u044b \u043d\u0435 \u0443\u0447\u043b\u0438 rate limiting \u0438 \u0434\u0443\u043c\u0430\u043b\u0438, \u0447\u0442\u043e 50 RPM (\u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0432 \u043c\u0438\u043d\u0443\u0442\u0443) \u043d\u0430 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u043c \u0442\u0430\u0440\u0438\u0444\u0435 \u2014 \u044d\u0442\u043e \u00ab\u0431\u0435\u0441\u043a\u043e\u043d\u0435\u0447\u043d\u043e \u043c\u043d\u043e\u0433\u043e\u00bb. \u0421 \u0442\u0435\u0445 \u043f\u043e\u0440 \u043c\u044b \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u0430\u043b\u0438 \u0430\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0443, \u0434\u043e\u0431\u0430\u0432\u0438\u043b\u0438 \u043e\u0447\u0435\u0440\u0435\u0434\u0438, \u043a\u044d\u0448\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u0438 middleware \u0434\u043b\u044f retry. \u0412 \u044d\u0442\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u0440\u0430\u0437\u0431\u0435\u0440\u0443, \u043a\u0430\u043a \u0441 \u043d\u0443\u043b\u044f \u043f\u043e\u0434\u0440\u0443\u0436\u0438\u0442\u044c Gemini API \u0441 Telegram-\u0431\u043e\u0442\u043e\u043c \u043d\u0430 aiogram 3.x, \u043d\u0435 \u043d\u0430\u0441\u0442\u0443\u043f\u0430\u044f \u043d\u0430 \u0442\u0435 \u0436\u0435 \u0433\u0440\u0430\u0431\u043b\u0438.\u0410\u0440\u0445\u0438\u0442\u0435\u043a\u0442\u0443\u0440\u0430: \u0447\u0442\u043e \u0438 \u0437\u0430\u0447\u0435\u043c\u041a\u043b\u0430\u0441\u0441\u0438\u0447\u0435\u0441\u043a\u0430\u044f \u0441\u0445\u0435\u043c\u0430 \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a: [Telegram User] \u2192 [aiogram Bot] \u2192 [Gemini API]                                     \u2193                    [Response Queue \/ Cache]\u041d\u043e \u0432 \u0440\u0435\u0430\u043b\u044c\u043d\u043e\u043c \u043f\u0440\u043e\u0434\u0430\u043a\u0448\u0435\u043d\u0435 \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u043e\u0431\u0432\u044f\u0437\u043a\u0430: [Telegram] \u2192 [aiogram] \u2192 [asyncio Queue] \u2192 [Rate Limiter] \u2192 [Gemini API]                             \u2191                                                                                 \u2193                 [Response Cache] \u2190\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 [Streaming Handler]\u041f\u043e\u0447\u0435\u043c\u0443 \u044d\u0442\u043e \u0432\u0430\u0436\u043d\u043e? Gemini API \u0438\u043c\u0435\u0435\u0442 \u0436\u0451\u0441\u0442\u043a\u0438\u0435 \u043b\u0438\u043c\u0438\u0442\u044b:1.\u0411\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u0442\u0430\u0440\u0438\u0444: 5\u201315 RPM \u0432 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u043e\u0442 \u043c\u043e\u0434\u0435\u043b\u04382.\u041e\u0442\u0432\u0435\u0442\u044b \u043c\u043e\u0433\u0443\u0442 \u0438\u0434\u0442\u0438 \u0434\u043e 10\u201315 \u0441\u0435\u043a\u0443\u043d\u0434 \u043d\u0430 \u0434\u043b\u0438\u043d\u043d\u044b\u0445 \u043f\u0440\u043e\u043c\u043f\u0442\u0430\u0445.3.\u041f\u043b\u0430\u0442\u043d\u044b\u0439: \u0434\u043e 60 RPM \u0434\u043b\u044f Gemini 2.0 Flash\u0415\u0441\u043b\u0438 \u043f\u0440\u043e\u0441\u0442\u043e \u0432\u044b\u0437\u044b\u0432\u0430\u0442\u044c await client.models.generate_content() \u0432\u043d\u0443\u0442\u0440\u0438 \u0445\u0435\u043d\u0434\u043b\u0435\u0440\u0430 \u2014 \u0432\u044b \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u0435 \u0438\u0432\u0435\u043d\u0442-\u043b\u0443\u043f aiogram \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u0435 \u0442\u0430\u0439\u043c\u0430\u0443\u0442\u044b \u043e\u0442 Telegram. \u0410\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u043e\u0441\u0442\u044c aiogram \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u0441\u043f\u0430\u0441\u0430\u0435\u0442 \u2014 \u0431\u043b\u043e\u043a\u0438\u0440\u0443\u044e\u0449\u0438\u0439 \u0432\u044b\u0437\u043e\u0432 \u043e\u0441\u0442\u0430\u0451\u0442\u0441\u044f \u0431\u043b\u043e\u043a\u0438\u0440\u0443\u044e\u0449\u0438\u043c.\u0428\u0430\u0433 1. \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u0438 \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 Gemini API\u0421\u0442\u0430\u0432\u0438\u043c \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443 Google GenAI SDK (\u043e\u043d\u0430 \u0436\u0435 google-genai):pip install google-genai aiogram python-dotenv\u0421\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442\u0412\u0430\u0436\u043d\u043e: \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 google-generativeai \u0443\u0441\u0442\u0430\u0440\u0435\u043b\u0430 \u0438 \u0441 \u043c\u0430\u044f 2025 \u0433\u043e\u0434\u0430 \u043d\u0435 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044f. \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 \u0438\u043c\u0435\u043d\u043d\u043e google-genai \u0421\u043e\u0437\u0434\u0430\u0451\u043c .env \u0444\u0430\u0439\u043b:GEMINI_API_KEY=your-api-key-hereTELEGRAM_BOT_TOKEN=your-bot-token\u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c API-\u043a\u043b\u044e\u0447 \u043c\u043e\u0436\u043d\u043e \u0432 Google AI Studio \u2192 API Keys \u2192 Create API Key.\u0411\u0430\u0437\u043e\u0432\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442: # gemini_client.pyimport osfrom google import genaifrom google.genai import typesclass GeminiClient:    def __init__(self, model: str = «gemini-3-flash-preview»):        self.client = genai.Client()  # \u043a\u043b\u044e\u0447 \u0431\u0435\u0440\u0451\u0442\u0441\u044f \u0438\u0437 GEMINI_API_KEY        self.model = model        async def generate(self, prompt: str) -> str:        # \u041e\u0431\u0440\u0430\u0442\u0438\u0442\u0435 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435: \u044d\u0442\u043e \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439 \u0432\u044b\u0437\u043e\u0432!        # await \u0437\u0434\u0435\u0441\u044c \u043d\u0435 \u043f\u043e\u043c\u043e\u0436\u0435\u0442, \u043d\u0443\u0436\u0435\u043d asyncio.to_thread        response = self.client.models.generate_content(            model=self.model,            contents=prompt        )        return response.text\u0421\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442\u0412\u0430\u0436\u043d\u043e\u0435 \u0437\u0430\u043c\u0435\u0447\u0430\u043d\u0438\u0435: \u043a\u043b\u0438\u0435\u043d\u0442 google-genai \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439! \u0412 \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u043e\u043c aiogram \u0435\u0433\u043e \u0432\u044b\u0437\u043e\u0432\u044b \u0431\u0443\u0434\u0443\u0442 \u0431\u043b\u043e\u043a\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0438\u0432\u0435\u043d\u0442-\u043b\u0443\u043f. \u0428\u0430\u0433 2. \u0410\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u0430\u044f \u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u0447\u0435\u0440\u0435\u0437 asyncio.to_thread\u0427\u0442\u043e\u0431\u044b \u043d\u0435 \u0432\u0435\u0448\u0430\u0442\u044c \u0432\u0435\u0441\u044c \u0431\u043e\u0442 \u043d\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441 \u043a Gemini, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c asyncio.to_thread:# async_gemini.pyimport asynciofrom google import genaiclass AsyncGeminiClient:    def __init__(self, model: str = «gemini-3-flash-preview»):        self.client = genai.Client()        self.model = model        async def generate(self, prompt: str) -> str:        loop = asyncio.get_event_loop()        # \u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u043c \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439 \u0432\u044b\u0437\u043e\u0432 \u0432 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u043c \u043f\u043e\u0442\u043e\u043a\u0435        response = await loop.run_in_executor(            None,  # \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c \u0434\u0435\u0444\u043e\u043b\u0442\u043d\u044b\u0439 ThreadPoolExecutor            self._sync_generate,            prompt        )        return response        def _sync_generate(self, prompt: str) -> str:        response = self.client.models.generate_content(            model=self.model,            contents=prompt        )        return response.text\u0421\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442\u042d\u0442\u043e \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u043e \u0436\u0438\u0437\u043d\u0435\u0441\u043f\u043e\u0441\u043e\u0431\u043d\u044b\u0439 \u0432\u0430\u0440\u0438\u0430\u043d\u0442. \u0414\u043b\u044f \u043f\u0440\u043e\u0434\u0430\u043a\u0448\u0435\u043d\u0430 \u043f\u043e\u043d\u0430\u0434\u043e\u0431\u0438\u0442\u0441\u044f \u0435\u0449\u0451 \u043e\u0447\u0435\u0440\u0435\u0434\u044c \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432. \u0428\u0430\u0433 3. \u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f \u0441 aiogram\u0411\u0430\u0437\u043e\u0432\u044b\u0439 \u0445\u0435\u043d\u0434\u043b\u0435\u0440 \u0434\u043b\u044f aiogram 3.x: # bot.pyimport asyncioimport loggingfrom aiogram import Bot, Dispatcher, Router, typesfrom aiogram.filters import Commandfrom aiogram.enums import ParseModefrom dotenv import load_dotenvfrom async_gemini import AsyncGeminiClientload_dotenv()logging.basicConfig(level=logging.INFO)router = Router()gemini = AsyncGeminiClient()@router.message(Command(«start»))async def cmd_start(message: types.Message):    await message.answer(        «\u041f\u0440\u0438\u0432\u0435\u0442! \u042f \u0431\u043e\u0442 \u0441 Gemini API. \u041f\u0440\u043e\u0441\u0442\u043e \u043d\u0430\u043f\u0438\u0448\u0438 \u043c\u043d\u0435 \u0432\u043e\u043f\u0440\u043e\u0441, \u0438 \u044f \u043e\u0442\u0432\u0435\u0447\u0443.»    )@router.message()async def handle_message(message: types.Message):    # \u041f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u043c, \u0447\u0442\u043e \u0431\u043e\u0442 «\u043f\u0435\u0447\u0430\u0442\u0430\u0435\u0442»    await message.bot.send_chat_action(        chat_id=message.chat.id,        action=»typing»    )        try:        response = await gemini.generate(message.text)        # Telegram \u0438\u043c\u0435\u0435\u0442 \u043b\u0438\u043c\u0438\u0442 4096 \u0441\u0438\u043c\u0432\u043e\u043b\u043e\u0432 \u043d\u0430 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435        if len(response) > 4000:            # \u0420\u0430\u0437\u0431\u0438\u0432\u0430\u0435\u043c \u043d\u0430 \u0447\u0430\u0441\u0442\u0438            for i in range(0, len(response), 4000):                await message.answer(response[i:i+4000])        else:            await message.answer(response)    except Exception as e:        logging.error(f»Gemini error: {e}»)        await message.answer(            «\u0427\u0442\u043e-\u0442\u043e \u043f\u043e\u0448\u043b\u043e \u043d\u0435 \u0442\u0430\u043a. \u041f\u043e\u043f\u0440\u043e\u0431\u0443\u0439\u0442\u0435 \u043f\u043e\u0437\u0436\u0435 \u0438\u043b\u0438 \u0441\u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u0443\u0439\u0442\u0435 \u0437\u0430\u043f\u0440\u043e\u0441 \u0438\u043d\u0430\u0447\u0435.»        )async def main():    bot = Bot(token=os.getenv(«TELEGRAM_BOT_TOKEN»))    dp = Dispatcher()    dp.include_router(router)        await dp.start_polling(bot)if __name__ == «__main__»:    asyncio.run(main())\u0428\u0430\u0433 4. \u0424\u0443\u043d\u043a\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439 \u0432\u044b\u0437\u043e\u0432 (Function Calling) \u0434\u043b\u044f \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u044f \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0435\u0439Gemini \u0443\u043c\u0435\u0435\u0442 \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0442\u0435\u043a\u0441\u0442, \u043d\u043e \u0438 \u0432\u044b\u0437\u044b\u0432\u0430\u0442\u044c \u0432\u043d\u0435\u0448\u043d\u0438\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u0438. \u042d\u0442\u043e \u043f\u043e\u043b\u0435\u0437\u043d\u043e, \u0435\u0441\u043b\u0438 \u0431\u043e\u0442 \u0434\u043e\u043b\u0436\u0435\u043d \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0441 \u0440\u0435\u0430\u043b\u044c\u043d\u044b\u043c\u0438 \u0434\u0430\u043d\u043d\u044b\u043c\u0438: \u0431\u0440\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0432\u0441\u0442\u0440\u0435\u0447\u0438, \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0442\u044c \u0441\u0442\u0430\u0442\u0443\u0441 \u0437\u0430\u043a\u0430\u0437\u0430, \u0438\u0441\u043a\u0430\u0442\u044c \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u0432 \u0431\u0430\u0437\u0435. \u041f\u0440\u0438\u043c\u0435\u0440 \u0434\u043b\u044f \u043f\u043b\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0432\u0441\u0442\u0440\u0435\u0447:# function_calling.pyfrom google import genaifrom google.genai import types# \u041e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u043c \u0444\u0443\u043d\u043a\u0446\u0438\u044e, \u043a\u043e\u0442\u043e\u0440\u0443\u044e Gemini \u043c\u043e\u0436\u0435\u0442 \u0432\u044b\u0437\u0432\u0430\u0442\u044cschedule_meeting_function = {    «name»: «schedule_meeting»,    «description»: «\u0421\u043e\u0437\u0434\u0430\u0451\u0442 \u0432\u0441\u0442\u0440\u0435\u0447\u0443 \u0441 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u043c\u0438 \u0443\u0447\u0430\u0441\u0442\u043d\u0438\u043a\u0430\u043c\u0438»,    «parameters»: {        «type»: «object»,        «properties»: {            «attendees»: {                «type»: «array»,                «items»: {«type»: «string»},                «description»: «\u0421\u043f\u0438\u0441\u043e\u043a email \u0443\u0447\u0430\u0441\u0442\u043d\u0438\u043a\u043e\u0432»,            },            «date»: {                «type»: «string»,                «description»: «\u0414\u0430\u0442\u0430 \u0432\u0441\u0442\u0440\u0435\u0447\u0438 (\u0413\u0413\u0413\u0413-\u041c\u041c-\u0414\u0414)»,            },            «time»: {                «type»: «string»,                «description»: «\u0412\u0440\u0435\u043c\u044f \u0432\u0441\u0442\u0440\u0435\u0447\u0438 (\u0427\u0427:\u041c\u041c)»,            },            «topic»: {                «type»: «string»,                «description»: «\u0422\u0435\u043c\u0430 \u0432\u0441\u0442\u0440\u0435\u0447\u0438»,            },        },        «required»: [«attendees», «date», «time», «topic»],    },}# \u0420\u0435\u0430\u043b\u044c\u043d\u0430\u044f \u0444\u0443\u043d\u043a\u0446\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u0443\u044e \u043c\u044b \u0431\u0443\u0434\u0435\u043c \u0432\u044b\u0437\u044b\u0432\u0430\u0442\u044cdef schedule_meeting(attendees: list, date: str, time: str, topic: str):    # \u0417\u0434\u0435\u0441\u044c \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0432\u044b\u0437\u043e\u0432 Google Calendar API, \u0411\u0414 \u0438 \u0442.\u0434.    return f»\u0412\u0441\u0442\u0440\u0435\u0447\u0430 ‘{topic}’ \u0437\u0430\u043f\u043b\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0430 \u043d\u0430 {date} \u0432 {time} \u0441 {‘, ‘.join(attendees)}»# \u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f \u0441 Geminiclient = genai.Client()tools = types.Tool(function_declarations=[schedule_meeting_function])config = types.GenerateContentConfig(tools=[tools])response = client.models.generate_content(    model=»gemini-3-flash-preview»,    contents=»\u0417\u0430\u043f\u043b\u0430\u043d\u0438\u0440\u0443\u0439 \u0432\u0441\u0442\u0440\u0435\u0447\u0443 \u0441 bob@company.com \u0438 alice@company.com \u043d\u0430 15.04.2026 \u0432 14:00 \u043f\u043e \u043f\u043e\u0432\u043e\u0434\u0443 \u0437\u0430\u043f\u0443\u0441\u043a\u0430 \u043f\u0440\u043e\u0434\u0443\u043a\u0442\u0430»,    config=config,)if response.candidates[0].content.parts[0].function_call:    fc = response.candidates[0].content.parts[0].function_call    print(f»Gemini \u0445\u043e\u0447\u0435\u0442 \u0432\u044b\u0437\u0432\u0430\u0442\u044c: {fc.name}»)    print(f»\u0421 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u0430\u043c\u0438: {fc.args}»)    # \u0412\u044b\u0437\u044b\u0432\u0430\u0435\u043c \u043d\u0430\u0448\u0443 \u0444\u0443\u043d\u043a\u0446\u0438\u044e \u0441 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u0430\u043c\u0438 \u043e\u0442 Gemini    result = schedule_meeting(**fc.args)    print(result)\u042d\u0442\u043e \u043c\u043e\u0449\u043d\u044b\u0439 \u043f\u0430\u0442\u0442\u0435\u0440\u043d, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043f\u0440\u043e\u0441\u0442\u043e\u0433\u043e \u0447\u0430\u0442-\u0431\u043e\u0442\u0430 \u0432 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0435\u0433\u043e \u0430\u0433\u0435\u043d\u0442\u0430. \u0428\u0430\u0433 5. \u041a\u044d\u0448\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u043e\u0442\u0432\u0435\u0442\u043e\u0432 (\u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u043f\u043b\u0430\u0442\u0438\u0442\u044c \u0434\u0432\u0430\u0436\u0434\u044b)Gemini API \u0442\u0430\u0440\u0438\u0444\u0438\u0446\u0438\u0440\u0443\u0435\u0442\u0441\u044f \u043f\u043e \u0442\u043e\u043a\u0435\u043d\u0430\u043c. \u0415\u0441\u043b\u0438 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0438 \u0447\u0430\u0441\u0442\u043e \u0437\u0430\u0434\u0430\u044e\u0442 \u043e\u0434\u043d\u0438 \u0438 \u0442\u0435 \u0436\u0435 \u0432\u043e\u043f\u0440\u043e\u0441\u044b (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u00ab\u043a\u0430\u043a \u0441\u0431\u0440\u043e\u0441\u0438\u0442\u044c \u043f\u0430\u0440\u043e\u043b\u044c\u00bb), \u0432\u044b \u0431\u0443\u0434\u0435\u0442\u0435 \u043f\u043b\u0430\u0442\u0438\u0442\u044c \u0437\u0430 \u043a\u0430\u0436\u0434\u044b\u0439 \u0437\u0430\u043f\u0440\u043e\u0441. \u0420\u0435\u0448\u0435\u043d\u0438\u0435 \u2014 \u043f\u0440\u043e\u0441\u0442\u043e\u0439 in-memory \u043a\u044d\u0448: # cache.pyimport hashlibfrom datetime import datetime, timedeltafrom typing import Optionalclass SimpleCache:    def __init__(self, ttl_seconds: int = 3600):        self._cache = {}        self._ttl = ttl_seconds        def get(self, key: str) -> Optional[str]:        if key in self._cache:            value, timestamp = self._cache[key]            if datetime.now() — timestamp < timedelta(seconds=self._ttl):                return value            else:                del self._cache[key]        return None        def set(self, key: str, value: str):        self._cache[key] = (value, datetime.now())        @staticmethod    def hash_prompt(prompt: str) -> str:        return hashlib.md5(prompt.lower().strip().encode()).hexdigest()\u0412 \u0445\u0435\u043d\u0434\u043b\u0435\u0440\u0435 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c: cache = SimpleCache(ttl_seconds=7200)  # 2 \u0447\u0430\u0441\u0430@router.message()async def handle_message(message: types.Message):    prompt_hash = cache.hash_prompt(message.text)    cached = cache.get(prompt_hash)        if cached:        await message.answer(cached)        return        response = await gemini.generate(message.text)    cache.set(prompt_hash, response)    await message.answer(response)\u0413\u0440\u0430\u0431\u043b\u0438 (\u0442\u043e, \u043e \u0447\u0451\u043c \u043d\u0435 \u043f\u0438\u0448\u0443\u0442 \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438)\u0413\u0440\u0430\u0431\u043b\u0438 \u21161: 429 \u043e\u0448\u0438\u0431\u043a\u0430 \u0432 \u043f\u044f\u0442\u043d\u0438\u0446\u0443 \u0432\u0435\u0447\u0435\u0440\u043e\u043c\u0421\u0430\u043c\u0430\u044f \u0447\u0430\u0441\u0442\u0430\u044f \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430 \u2014 RESOURCE_EXHAUSTED (429). \u041f\u0440\u0438\u0447\u0438\u043d\u044b:RPM-\u043b\u0438\u043c\u0438\u0442. \u0411\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u0442\u0430\u0440\u0438\u0444 \u0434\u0430\u0451\u0442 5 RPM, \u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u2014 \u0434\u043e 60 RPMTPM-\u043b\u0438\u043c\u0438\u0442. \u041e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0435 \u043d\u0430 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0442\u043e\u043a\u0435\u043d\u043e\u0432 \u0432 \u043c\u0438\u043d\u0443\u0442\u0443 (1M \u0434\u043b\u044f \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u043e\u0433\u043e \u0442\u0430\u0440\u0438\u0444\u0430).RPD-\u043b\u0438\u043c\u0438\u0442. \u041e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u0435 \u043d\u0430 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0432 \u0434\u0435\u043d\u044c (25\u20131500 \u0432 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 \u043e\u0442 \u043c\u043e\u0434\u0435\u043b\u0438).\u0420\u0435\u0448\u0435\u043d\u0438\u0435: \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 rate limiter \u043d\u0430 \u0441\u0442\u043e\u0440\u043e\u043d\u0435 \u0431\u043e\u0442\u0430:# rate_limiter.pyimport asyncioimport timeclass AsyncRateLimiter:    def __init__(self, max_requests: int, time_window: int = 60):        self.max_requests = max_requests        self.time_window = time_window        self.requests = []        self._lock = asyncio.Lock()        async def acquire(self):        async with self._lock:            now = time.time()            # \u0423\u0434\u0430\u043b\u044f\u0435\u043c \u0441\u0442\u0430\u0440\u044b\u0435 \u0437\u0430\u043f\u0440\u043e\u0441\u044b            self.requests = [t for t in self.requests if now — t < self.time_window]                        if len(self.requests) >= self.max_requests:                sleep_time = self.time_window — (now — self.requests[0])                await asyncio.sleep(sleep_time + 0.1)    …<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-476567","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/476567","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=476567"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/476567\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=476567"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=476567"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=476567"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}