Перейти к основному содержимому

FAQ

Что такое дублоны?​

Валюта PiratePress: 1 🪙 = 1 ₽. Цены те же, что в боте: база ролика 100 🪙 плюс выбранные допы (плейсмент, AI-визуал, песня и т.д.). Сколько фактически списали — в поле cost ответа на создание заказа. Пополнение — в боте: /balance (карта/СБП через Platega или Telegram Stars).

Какие лимиты?​

На один ключ: 10 активных задач (queued + running; ролики и нарезки вместе — заказ клипа ест ту же квоту) и 30 POST в минуту; сверх — 429 с Retry-After (см. Коды ошибок). API-задачи стоят в отдельной очереди с приоритетом ниже бот-пользователей: ETA из eta_seconds честный, но в час пик может плавать — закладывайся на поллинг/вебхуки, а не на фиксированное время.

А нарезка и каналы доступны через API?​

Да. Нарезка длинных видео на клипы — домен /clips (оценка цены probe, заказ с обязательным Idempotency-Key, клипы с подписанными ссылками и zip-паком, AI-баннер): см. Нарезка. Каналы — домен /channels (пресет + ниша, LLM-концепции, «ролик сейчас» по каналу, расписание автовыпуска): см. Каналы. Клипы и ролики канала помечаются вебхуками clip.done/clip.error и video.done/video.error соответственно.

Работает ли триал через API?​

Да. Бесплатные ролики новичка (стартовый пакет за /start в боте) применяются автоматически, пока не исчерпаны, — в том числе при заказе через API. На триальных роликах принудительная вотермарка piratepress.fun, как в боте. Когда триал кончился, заказы идут за дублоны; нехватка баланса — 402 insufficient_funds.

Что за режиссёрский режим?​

director_mode: true в POST /videos — генерация встаёт на паузу после сценария: заказ переходит в awaiting_review (приходит вебхук video.awaiting_review). Решение — POST /videos/{id}/review:

  • {"action": "approve"} — сценарий устраивает, генерируем дальше;
  • {"action": "edit", "text": "…"} — генерируем по твоей правке текста;
  • {"action": "regen", "note": "…"} — переписать сценарий с пожеланием.

Ответить 409 not_awaiting_review — значит, заказ сейчас не ждёт ревью.

Где полный референс?​

Интерактивный (Scalar): https://api.piratepress.fun/public/v1/docs. Сырая схема: https://api.piratepress.fun/public/v1/openapi.json — из неё генерируются типы SDK. Контракт /public/v1 заморожен: изменения только аддитивные, ломающие — в /public/v2.

Ключ утёк, что делать?​

/apikey в боте → отозвать. Отозванный ключ сразу начинает получать 401. Учти: /stop в боте удаляет аккаунт целиком — ключ умирает вместе с ним, а заказы и файлы стираются безвозвратно.

Сколько живут результаты?​

Файлы заказа (mp4, обложки, постинг-пак) хранятся 30 дней, потом удаляются — скачивай сразу. Подписанная result_url живёт 7 дней: протухла — просто переспроси GET /videos/{id} и получи свежую.

Есть ли SDK?​

Python (piratepress, PyPI) и JS (@piratepress/sdk, npm): тонкие клиенты поверх этого же контракта — ретраи, Retry-After, автоматический Idempotency-Key и хелпер проверки webhook-подписи из коробки. Если пишешь свой клиент — ориентируйся на OpenAPI-схему как источник правды.

Остались вопросы — @piratepress_support.