Возможности / URL API

URL API: справочник параметров

Генерируйте изображения одним HTTP GET-запросом — без SDK, без настройки и без бэкенда.

Достаточно вставить URL в <img src="..."> вашего сайта. Сервер примет запрос, проверит Redis-кеш и вернёт готовое изображение.

Самый простой запрос:
https://pixinlink.ru/800x400/кофе-на-столе-утром

→ Готовое изображение 800×400px в формате WebP.

TL;DR

URL API = GET-запрос → изображение (или 302 редирект на CDN URL).
Формат: /{width}x{height}/{prompt}?style=...&seed=...
Параметры: prompt, seed, style — читаются из URL.
Аутентификация: привязка домена через Referer (не API-ключ).
Справочник ниже — всё для copy-paste.

Ключевые факты

  • done Один GET-запрос → изображение: POST не нужен, тело запроса не нужно.
  • done Два пути: pixinlink.ru/800x400/... (основной) и /api/v1/800x400/... (альтернативный).
  • done Аутентификация по домену: Referer-заголовок определяет, привязан ли домен. Без привязки — анонимный тариф.
  • done Стили: default, illustration, 3d, anime, photographic, minimal, dark.
  • done Redis-кеш: ключ — url_path. Cache hit = 200 OK. CDN-кеш = 302 редирект.
  • done 500 символов: максимальная длина промпта (обрезается).
  • done 12 изображений бесплатно: без регистрации, без карты.
  • done Rate limit: 50 запросов/минуту для всех.

Как работает запрос (Архитектура)

  1. Шаг 1: Клиент отправляет GET-запрос к pixinlink.ru/800x400/промпт.
  2. Шаг 2: Сервер проверяет заголовок Referer → определяет домен → ищет пользователя с привязанным доменом → устанавливает add_wm и лимиты.
  3. Шаг 3a (Redis Cache Hit): Изображение найдено в Redis (ключ: gen:800x400) → HTTP 200 OK с готовым файлом. Квота не тратится.
  4. Шаг 3b (CDN Cache Hit): Изображение в CDN-кеше → HTTP 302 Found редирект на CDN URL.
  5. Шаг 3c (Cache Miss): Изображения нет в кеше → синхронная генерация через GigaChat (10–30 сек) → WebP → сохранение в Redis-кеш → возврат.

Параметры URL

Формат: /{width}x{height}/{prompt}?style=...&seed=...

ПараметрТипГдеПримерОграничения
width integer path 800 16–4096 px (clamped)
height integer path 400 16–4096 px (clamped)
prompt string path или query офис-разработчиков Макс 500 символов (обрезается). URL-encode для пробелов.
style string query illustration default (по умолчанию). Неизвестные → default.
seed integer query 42 Без явной валидации диапазона. Фиксирует результат.

Примечание: значения размеров вне диапазона «зажимаются» (clamped) до 4096 без ошибки. Параметры watermark, format и callback не обрабатываются catch-all endpoint — они работают только в REST API (POST /images/generate).

Стили (style)

Параметр &style= управляет художественным стилем генерации. Неизвестные значения падают на default.

ЗначениеОписание
defaultФотореализм (по умолчанию)
illustrationЦифровая живопись (персонажи, концепт-арт)
3d3D-рендер (продукты, техника)
animeАниме/манга стиль
photographicФотографический (аналог default)
minimalМинималистичный (аналог default)
darkТёмная стилистика (аналог default)

Seed: воспроизводимые результаты

Тип: integer. Если не передан — каждый cache miss генерирует уникальное изображение. Если передан — одинаковый prompt + seed всегда дают одинаковый результат. Идеально для og:image.

PHP (crc32 из slug)
function pixinlink_seed(string $slug): int {
    return abs(crc32($slug)) % 2147483647;
}
JavaScript
function getSeed(slug) {
  let hash = 0;
  for (let i=0; i<slug.length; i++) {
    hash = ((hash << 5) - hash) + slug.charCodeAt(i);
  }
  return Math.abs(hash) % 2147483647 || 1;
}

Аутентификация

URL API использует аутентификацию по домену через заголовок Referer — не Bearer-токен. Сервер извлекает домен из Referer и ищет пользователя с привязанным доменом.

Анонимный доступ (Free)
GET https://pixinlink.ru/800x400/офис

12 генераций/мес. Водяной знак. Без регистрации.

С привязанным доменом (Starter+)
GET https://pixinlink.ru/800x400/офис

Referer: ваш-сайт.ru → сервер определяет домен → без знака, полная квота.

Коды ответов HTTP

КодСтатусОписание
200 OK Redis cache hit — изображение отдано из кеша
302 Found CDN cache hit — редирект на CDN URL
400 Bad Request Ошибка в параметрах запроса
429 Too Many Requests Превышен rate limit или месячная квота

Квоты и лимиты

Rate limit для catch-all endpoint — 50 запросов/минуту для всех (единый лимит). Cache hit (200/302) не считается генерацией — квота не расходуется. Списание только при cache miss.

ТарифКвота (генераций/мес)Сброс квоты
Free12Календарный месяц
Starter50Календарный месяц
Pro500Календарный месяц
Business1 000Календарный месяц

Полный пример запроса

GET https://pixinlink.ru/1200x630/современный-офис-разработчиков
?style=illustration
&seed=20260515
Referer: https://мой-сайт.ru/blog/post

Если домен «мой-сайт.ru» привязан к аккаунту — изображение будет без водяного знака. Если нет — со знаком.

Попробуйте прямо сейчас

12 бесплатных генераций. Без регистрации, без карты.

Выбрать тариф Начало работы →
buildingbuildingbuilding