Справочник

from sidekick_ads import Sidekick
from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton

sk = Sidekick(api_key="sk_live_xxx", platform_id="plt_xxx")

result = await sk.fetch(
    user_id=message.from_user.id,
    language_code=message.from_user.language_code or "en",
    parse_mode="HTML",  # Match the parse mode used when sending.
)

if result.has_ad and result.ad is not None:
    await message.answer(
        f"{llm_reply}\n\n{result.ad.ad_text_formatted}",
        parse_mode="HTML",
        reply_markup=InlineKeyboardMarkup(inline_keyboard=[[
            InlineKeyboardButton(
                text=result.ad.button_text, url=result.ad.button_url,
            ),
        ]]),
    )
else:
    await message.answer(llm_reply)

from sidekick_ads import Sidekick
from aiogram.types import (
    InlineKeyboardMarkup, InlineKeyboardButton, BufferedInputFile,
)

sk = Sidekick(api_key="sk_live_xxxxx", platform_id="plt_xxxxx")

result = await sk.fetch_image(
    user_id=message.from_user.id,
    language_code="en",
    parse_mode="HTML",
)
if result.has_ad and result.ad:
    ad = result.ad
    # SDK already downloaded the bytes — hand straight to InputFile.
    media = BufferedInputFile(ad.image_data, filename=ad.image_filename)
    kb = InlineKeyboardMarkup(inline_keyboard=[[
        InlineKeyboardButton(text=ad.button_text, url=ad.button_url)
    ]])
    caption = ad.ad_text_formatted or ad.ad_text
    if ad.media_type == "animation":
        await message.answer_animation(media, caption=caption,
                                       parse_mode="HTML", reply_markup=kb)
    else:
        await message.answer_photo(media, caption=caption,
                                   parse_mode="HTML", reply_markup=kb)

# On a handled Sidekick request error:
result = await sk.inject(user_id=123, message="Hello world", language_code="en")
# result.message == "Hello world"  (unchanged)
# result.has_ad == False
# result.keyboard == None  (or your original keyboard)