Уникализация видео (unique)

Отдельный сценарий «анти-тень»: присылаешь готовый ролик (ссылка или файл из медиатеки) — получаешь его уникализированную версию. Без нарезки, субтитров и баннеров: только незаметные глазу правки кадра и звука (скорость, тон голоса, зум, оттенок, зерно, опционально зеркало) плюс чистые метаданные и случайный профиль кодирования — платформы не склеивают заливки в дубли и не кидают в теневой бан.

Цена: 5 🪙 за минуту исходника, минимум 30 🪙, исходник до 60 минут; каждая версия сверх первой +10 🪙. При сбое списанное возвращается полностью. Все вызовы — с заголовком X-API-Key: pp_..., кроме скачивания файлов (там сама подписанная ссылка).

Базовый URL: https://api.piratepress.fun/public/v1.

Шаг 1. Заказать — `POST /unique`

Заголовок Idempotency-Key обязателен (повтор со своим ключом вернёт исходный заказ без повторного списания).

curl -X POST https://api.piratepress.fun/public/v1/unique \
  -H "X-API-Key: pp_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-0001" \
  -d '{
    "source_url": "https://youtube.com/watch?v=...",
    "uniquify": "soft",
    "variants": 2
  }'

Тело (PublicUniqueOrderCreate):

Поле	Тип	По умолчанию	Что значит
`source_url`	string	—	Ссылка на видео (http/https). Ровно один из `source_url`/`source_asset_id` обязателен
`source_asset_id`	string	—	Видео из медиатеки (id из `GET /assets`)
`uniquify`	soft/strong/custom	—	Обязателен. `soft` — незаметные правки; `strong` — то же + зеркальный кадр (надписи станут зеркальными); `custom` — свой набор
`uniquify_opts`	object	—	Обязателен при `custom`: `mirror`/`speed`/`pitch`/`zoom`/`hue`/`grain` (bool)
`variants`	int 1–5	1	Сколько разных версий вернуть
`resolution`	string	`null`	`720x1280`/`1080x1920` — перекадрировать; `null` — сохранить геометрию исходника

Ответ 201:

{ "id": "uq_a1b2c3", "status": "queued", "cost": 40, "eta_seconds": 300 }

Исходник длиннее 60 минут — 422 invalid_params. Заказ ест общую квоту 10 активных задач на ключ (см. Коды ошибок).

Шаг 2. Забрать результат — `GET /unique/{id}`

curl https://api.piratepress.fun/public/v1/unique/uq_a1b2c3 \
  -H "X-API-Key: pp_..."

При status: "done":

{
  "id": "uq_a1b2c3",
  "status": "done",
  "files": [
    { "name": "unique_01.mp4", "variant": 1,
      "url": "https://api.piratepress.fun/public/v1/unique/files/eyJ..." },
    { "name": "unique_01_v2.mp4", "variant": 2,
      "url": "https://api.piratepress.fun/public/v1/unique/files/eyJ..." }
  ],
  "duration_seconds": 300.0,
  "cost": 40
}

Статусы: queued|running|done|error|refunded. При error/refunded списанное возвращено на баланс. Ссылки подписанные (HMAC, TTL 7 дней).

Куда дальше

Нарезка (clips) — то же + нарезка на клипы, субтитры, баннеры;
Коды ошибок — конверт {error: {code, message}}.

Шаг 1. Заказать — POST /unique​

Шаг 2. Забрать результат — GET /unique/{id}​

Куда дальше​

Шаг 1. Заказать — `POST /unique`

Шаг 2. Забрать результат — `GET /unique/{id}`

Куда дальше