StaticGramBot API

Картинки и анимации NFT-подарков

У каждого коллекционного подарка StaticGram есть публичные ссылки на готовую картинку и на полную Lottie-анимацию. Формат тот же, что у nft.fragment.com/gift/… в Telegram: фон, узор и модель уже собраны. Ключ не нужен.

Ссылки

Подставьте slug подарка: это последняя часть ссылки staticgram.top/nft/<slug>, например plush-pepe-x147.

СсылкаЧто отдаёт
https://staticgram.top/gift/<slug>.large.jpgJPEG 640×640
https://staticgram.top/gift/<slug>.medium.jpgJPEG 320×320
https://staticgram.top/gift/<slug>.small.jpgJPEG 160×160
https://staticgram.top/gift/<slug>.lottie.jsonLottie 512×512, 60 fps: фон, узор и анимированная модель в одном файле

Пример: staticgram.top/gift/plush-pepe-x147.large.jpg

Как устроено изображение

  • Фон: радиальный градиент цвета фона подарка (backdrop).
  • Узор: 23 символа в три кольца вокруг модели, цветом узора фона. Прозрачность от центра к краю: 24%, 15% и 10%.
  • Модель: по центру, 63% размера. Картинка — это первый кадр анимации.
  • Номера подарка на картинке нет, как и у Fragment.

Кэш и ответы

  • Cache-Control: public, max-age=86400 и ETag. ETag меняется, если у подарка сменились атрибуты (например, после крафта), поэтому кэш обновляется сам.
  • Access-Control-Allow-Origin: *: ссылки можно грузить прямо со страниц и из мини-аппов.
  • .lottie.json отдаётся со сжатием gzip, если клиент его поддерживает.
  • 404: подарка с таким slug нет, он сожжён или у него нет модели.

Пример: показать анимацию на сайте

lottie-web
<div id="nft" style="width:320px;height:320px"></div>
<script src="https://cdnjs.cloudflare.com/ajax/libs/lottie-web/5.12.2/lottie.min.js"></script>
<script>
  lottie.loadAnimation({
    container: document.getElementById("nft"),
    renderer: "svg", loop: true, autoplay: true,
    path: "https://staticgram.top/gift/plush-pepe-x147.lottie.json"
  });
</script>
Python
import urllib.request

slug = "plush-pepe-x147"
with urllib.request.urlopen(f"https://staticgram.top/gift/{slug}.large.jpg") as r:
    open(f"{slug}.jpg", "wb").write(r.read())

Описания методов и типов взяты из официальной документации Telegram Bot API (Bot API 10.3). Адрес API: https://api.staticgram.top