TL;DR

URL → SHA-256 хеш → Redis проверка →
  • Кеш есть: 302 CDN URL, <100 мс, квота не тратится
  • Кеша нет: SVG placeholder → Celery → Yandex Translate → Kandinsky 3.1
    → WebP → S3 → CDN (140 POP) → Redis
Первый запрос = 8 секунд (генерация).
Все повторные = мгновенно (кеш).
Инфраструктура: Yandex Cloud + Selectel, 152-ФЗ, Россия.

Почему это важно: запросы о «медленности» и «стоковости» — самые частые у новых пользователей. Эта страница отвечает на оба: медленность — это холодный старт CDN, уникальность — это диффузионная нейросеть, а не база фотографий.

PixInLink принимает URL вида pixinlink.ru/800x400/офис-разработчиков, вычисляет SHA-256 хеш параметров и проверяет CDN-кеш. Если изображение уже генерировалось — возвращает его мгновенно (<100 мс). Если нет — создаёт задачу: переводит промпт на английский (Yandex Translate), генерирует через Kandinsky 3.1 или FLUX.1, оптимизирует в WebP, сохраняет в Yandex Object Storage и кеширует на 1 год через CDN (140 POP). Первый запрос: 8–10 секунд. Повторные: менее 100 мс.

Браузер отправляет GET-запрос. API на FastAPI (Python 3.12) принимает и парсит URL.

Валидация: width/height 16–8192, HEX 6 символов, prompt не пустой. Если что-то не так → 400 Bad Request.

API вычисляет SHA-256 от нормализованных параметров. Каждая уникальная комбинация = уникальный ассет:

hash = SHA256("800x400/ffffff/000000?prompt=office&style=realistic&seed=42")
→ abc123def456...

Одинаковый prompt + seed = одинаковый хеш = тот же кешированный файл. Изменили seed — новый хеш — новое изображение.

API сразу возвращает SVG-заглушку (200 OK, ~200 байт) с заголовком X-Job-Id. SVG показывает фон цвета bg= с текстом «Generating image...». Браузер не ждёт 8 секунд — видит заглушку немедленно. Параллельно API создаёт запись в PostgreSQL (status=pending) и отправляет задачу в очередь Celery.

Задача появляется в Redis-очереди. Celery Worker берёт её. Приоритеты: high — Enterprise/Pro, default — обычные, bulk — batch. Пул: 3 GPU-воркера × concurrency=2 = 6 параллельных генераций одновременно. При длине очереди >50 → auto-scale добавляет воркер.

Три операции подряд:

1. Transliteration: «офис разработчиков» → Yandex Translate → "office of developers"
2. Style Augmentation: добавляется ", photorealistic, 8k, high detail"
3. Negative prompt: "blurry, low quality, distorted"

Диффузионные модели обучены преимущественно на английских данных. Yandex Translate + нативная RU-обучка Kandinsky = лучшее качество для кириллических промптов.

1. Decode: base64 → PIL Image
2. Resize: ImageOps.fit(width, height, LANCZOS) — точное кадрирование
3. Watermark (только Free): текст «Made with PixInLink.com», bottom-right, 30% opacity. Вшивается в пиксели — нельзя убрать через CSS или DevTools
4. Format: WebP quality=85, метод 6 → ~50KB vs ~300KB PNG. В 6 раз меньше → лучше PageSpeed
5. Strip EXIF/IPTC: все метаданные удаляются. Ваши промпты не хранятся в файле

Key: images/{sha256_hash}.webp
Cache-Control: public, max-age=31536000, immutable
x-amz-acl: public-read
Durability: 99.999999999%

Объект никогда не перезаписывается. Новые параметры → новый хеш → новый объект. Ваш og:image не изменится неожиданно.

• CDN: Yandex Cloud CDN, 140 POP по России и СНГ
• Redis: SET image:{hash} cdn_url EX 2592000 (30 дней)
• PostgreSQL: status=ready, cdnurl=..., generated_at=now()
• Следующий запрос с тем же URL → CDN edge → <100 мс ✅

flowchart TD
    A["Браузер: GET /800x400/офис"] --> B["API Gateway — FastAPI"]
    B --> C{"Redis Cache Check"}
    C -->|"Cache HIT"| D["302 CDN URL <100 мс ✅"]
    C -->|"Cache MISS"| E["SVG Placeholder 200 OK"]
    E --> F["Celery Queue — Redis Broker"]
    F --> G["Celery Worker"]
    G --> H["Yandex Translate RU → EN"]
    H --> I{"AI Provider"}
    I -->|"Primary"| J["Kandinsky 3.1 SberCloud ~8 сек"]
    I -->|"Fallback"| K["FLUX.1-schnell Selectel RTX 4090 ~4 сек"]
    J --> L["Image Processor Pillow: resize, WebP, watermark"]
    K --> L
    L --> M["Yandex Object Storage S3 immutable"]
    M --> N["Yandex CDN 140 POP"]
    N --> O["Redis UPDATE image:{hash}"]
    O --> P["Следующий запрос → Cache HIT <100 мс ✅"]

🎂 Аналогия: кондитерская

Представьте, что вы заказываете торт в кондитерской. Первый раз — кондитер печёт его специально для вас (8–10 минут). Но умный кондитер знает: если кто-то закажет такой же — он уже есть в витрине. Следующий покупатель получит его мгновенно. PixInLink работает так же: первая генерация — кулинарный процесс, все последующие — готовый торт в витрине CDN.

💡 500 генераций на Starter — это 500 уникальных промптов. Один промпт можно запрашивать миллион раз — квота тратится 1 раз при первой генерации.

Circuit Breaker: при 5 подряд ошибках Kandinsky → Circuit Breaker открывается на 60 сек. Все запросы идут прямо в FLUX. После 60 сек — пробный запрос к Kandinsky. Если OK — Circuit Breaker закрывается.

Архитектура PixInLink разработана командой с опытом в SaaS, distributed systems и computer vision. Все решения задокументированы в Architecture Decision Records (ADR): ADR-007 (Kandinsky/FLUX fallback), ADR-010 (Watermark). Мониторинг 24/7 через Grafana + Telegram-алерты.

• verifiedКодовые примеры актуальны для FastAPI 0.115, Celery 5.4, Python 3.12
• verifiedТехнические данные взяты из architecture/components.md и ADR-документов
• verifiedДата обновления: май 2026
• verifiedПоддержка: dev@pixinlink.ru · @pixinlinksupport