Один аккаунт
Аккаунт API это твой аккаунт Uniqly: тот же баланс, план или команда и дневной лимит, что в боте.
Uniqly API
Тот же сервис, что в боте, только для твоих скриптов и инструментов. Загружаешь одно видео, просишь до 10 копий, опрашиваешь задание и скачиваешь файлы.
Базовый адресhttps://api.uniqly.video
$ curl -X POST "https://api.uniqly.video/v1/jobs?copies=3" \
-H "Authorization: Bearer uq_YOUR_KEY" \
-H "Idempotency-Key: clip-01" \
--data-binary @clip.mp4
201 Created
{
"id": "Zq3vK8mTn4Lx0bW2cYd9Eg",
"status": "queued",
"copies_requested": 3,
"copies_ready": 0
}Аккаунт API это твой аккаунт Uniqly: тот же баланс, план или команда и дневной лимит, что в боте.
Копия стоит столько же, сколько в боте. Копии, которые не были выданы, не списываются.
К каждой копии прилагается её sha256. Скачай её в течение 24 часов после конца задания.
Ключ можно получить в кабинете на сайте или в боте, это один и тот же ключ. Он начинается с uq_ и показывается один раз, когда выдан: сервис хранит его хеш, а не сам ключ.
На сайте
Войди, открой кабинет и нажми «Получить ключ». Там же видно, когда ключом пользовались, и там же его можно отключить.
Открыть кабинетВ Telegram
Отправь /apikey new в личном чате с @UniqlyVideoBot. /apikey показывает ключ, /apikey off отключает его.
Береги ключ как пароль: копии, сделанные с ним, списываются с тебя. Отправляй его только в заголовке Authorization и только по HTTPS.
Каждый запрос, кроме GET /v1/health, несёт ровно один заголовок с ключом:
Authorization: Bearer uq_YOUR_KEYНет заголовка, он повторён, другая схема, неизвестный или отключённый ключ: на всё один ответ, 401 с кодом unauthorized.
403 forbidden.Четыре запроса через curl. Один раз задай базовый адрес и ключ:
API=https://api.uniqly.video
KEY=uq_YOUR_KEYОтправь видео телом запроса и укажи, сколько копий нужно. Idempotency-Key обязателен: любая строка до 64 букв, цифр и _ . -, новая для этого задания.
# 1. Создать задание: три копии clip.mp4, файл идёт телом запроса
curl -sS -X POST "$API/v1/jobs?copies=3" \
-H "Authorization: Bearer $KEY" \
-H "Idempotency-Key: clip-2026-10-01-a" \
-H "Content-Type: video/mp4" \
--data-binary @clip.mp4
# 201 с объектом задания: возьми из него "id"
JOB=Zq3vK8mTn4Lx0bW2cYd9EgЗапрашивай раз в несколько секунд, пока status не станет done или failed. copies_ready растёт по ходу работы, и готовые копии можно скачивать, не дожидаясь конца.
# 2. Опрашивать, пока "status" не станет "done" или "failed"
curl -sS "$API/v1/jobs/$JOB" -H "Authorization: Bearer $KEY"Пути лежат в files объекта задания. Оборванное скачивание можно продолжить заголовком Range, например curl -C -.
# 3. Скачать готовую копию, номера начинаются с 1
curl -sS -o copy-1.mp4 "$API/v1/jobs/$JOB/files/1" \
-H "Authorization: Bearer $KEY"Сравни хеш файла с sha256 этой копии. ETag загрузки это тот же хеш в кавычках.
# 4. Хеш должен совпасть с "sha256" этой копии
shasum -a 256 copy-1.mp4 # sha256sum copy-1.mp4Все пути идут от базового адреса. Время в UTC, размеры в байтах.
| Метод и путь | Ключ | Что делает |
|---|---|---|
POST /v1/jobs | да | загрузить одно видео и создать задание |
GET /v1/jobs/{id} | да | задание: статус, копии, сколько стоило |
GET /v1/jobs/{id}/files/{index} | да | скачать одну готовую копию |
DELETE /v1/jobs/{id}/files | да | удалить файлы законченного задания раньше срока |
GET /v1/me | да | твой аккаунт: режим, дневной лимит, кредиты |
GET /v1/health | нет | работает ли сервис |
Любой другой путь отвечает 404 not_found, метод, который путь не принимает, отвечает 405 с заголовком Allow. В каждом ответе есть Cache-Control: private, no-store.
GET /v1/me показывает аккаунт так же, как экран баланса в боте, даже когда тратить уже нечего. mode бывает credits, paid (план), team, comp (бесплатный доступ от Uniqly, у него может быть срок) или denied. День это календарный день сервера по UTC.
{
"mode": "credits",
"daily_limit": 50,
"used_today": 3,
"left_today": 47,
"credits": {"available": 7, "reserved": 3}
}POST /v1/jobs создаёт одно задание из одного файла. Пакетной загрузки, multipart-формы и загрузки по ссылке нет.
| Где | Имя | Обязателен | Значение |
|---|---|---|---|
| query | copies | да | сколько копий, целое число от 1 до 10, и не больше, чем одно задание может сделать из этого видео |
| query | strength | нет | n (по умолчанию), s или x, см. ниже |
| query | allow_repeat | нет | true или false (по умолчанию): сделать задание, даже если часть копий повторит прежнюю нарезку, см. ниже |
| query | allow_copy | нет | true или false (по умолчанию): принять файл, который сам является копией от сервиса |
| заголовок | Authorization | да | Bearer и твой ключ |
| заголовок | Idempotency-Key | да | от 1 до 64 символов из A-Z a-z 0-9 _ . -, новый для каждого задания |
| тело | | да | само видео, один файл MP4 или MOV до 95 МиБ |
| Код | В боте | Что меняется |
|---|---|---|
n | Обычная | лёгкий зум, по краям кадра срезается совсем немного |
s | Сильная | зум побольше, по краям уходит чуть больше |
x | Зеркало | как Сильная, плюс отражение по горизонтали (текст читается задом наперёд) |
201: новое задание. В теле объект задания, в Location его путь.200: этот Idempotency-Key уже создал задание. В теле это задание в текущем виде, ничего нового не списано.400, 401, 402, 403, 408, 409 no_fresh_framing и copy_of_copy, 413, 415, 422, любой 429, 503 maintenance) значит, что этот запрос не создал задание, ничего не зарезервировал и не оставил файла.500 или 503 busy исход неизвестен: повтори тот же запрос с тем же Idempotency-Key.Сервис помнит, где он нарезал каждую копию файла для твоего аккаунта (и команды), и режет каждую новую копию того же файла в стороне от всех прежних. У каждой силы ограниченное число таких нарезок на файл: у n меньше всего, у s и x больше.
409 no_fresh_framing; error.fresh_left показывает остаток для каждой силы. Попроси меньше копий, выбери другую силу или отправь allow_repeat=true.409 copy_of_copy. Отправь оригинал или allow_copy=true.files есть fresh: true, если нарезка новая для этого файла и аккаунта, false, если она повторяет прежнюю.GET /v1/jobs/{id} отвечает заданием. Задание чужого аккаунта отвечает 404, точно как несуществующий id.
{
"id": "Zq3vK8mTn4Lx0bW2cYd9Eg",
"status": "done",
"copies_requested": 3,
"copies_ready": 3,
"strength": "n",
"billing": "credits",
"credits": {"reserved": 3, "consumed": 3, "lost": 0, "returned": 0, "forfeited": 0},
"error": null,
"created_at": "2026-10-01T11:58:20.512094+00:00",
"finished_at": "2026-10-01T12:00:00.184312+00:00",
"expires_at": "2026-10-02T12:00:00.184312+00:00",
"files": [
{
"index": 1,
"size": 4812345,
"sha256": "be501d782587b077db6446b897d5037bfa4b68a590e761020be1979a2a484349",
"url": "/v1/jobs/Zq3vK8mTn4Lx0bW2cYd9Eg/files/1"
}
]
}statusqueued, running, done или failed.copies_readycopies_requested.billingcredits, если задание тратит кредиты, quota, если оно идёт в дневной лимит (план, команда, выданный доступ).creditsreserved, сколько consumed за выданные копии и returned за остальные; forfeited и lost, если пакет истёк или был возвращён, пока задание шло.quotacopies_counted, сколько засчитано в день.errornull или, у неудачного задания, один из кодов из раздела «Ошибки».expires_atfilesindex, size, sha256, url (её путь) и fresh. Пусто, когда файлы истекли или удалены.Время в ISO 8601 по UTC со смещением +00:00. url и Location это пути: подставляй перед ними базовый адрес.
Цена как в боте: один кредит за копию для аккаунта на кредитах. План, команда или выданный доступ вместо этого засчитывают копии в дневной лимит.
files, неважно, скачал ты её или нет.| Что | Лимит |
|---|---|
| Тело запроса | до 95 МиБ (99 614 720 байт), и заявленное, и фактическое |
| Файл | MP4 или MOV, первый блок которого ftyp. Один самодостаточный файл, без плейлистов |
| Длительность | от 0,5 до 180 секунд |
| Кадр | до 8 294 400 пикселей, вертикальный или горизонтальный (3840 × 2160) |
| Частота кадров | до 61 кадра в секунду и до 257 126 400 пикселей в секунду всего (31 кадр в секунду на самом большом кадре) |
| Копии | от 1 до 10 за задание, и не больше, чем одно задание может сделать из этого видео |
| Время загрузки | без пауз дольше 30 секунд, целиком за 10 минут |
| Заданий одновременно | 2 активных на аккаунт, вместе с идущими загрузками |
| Скачиваний одновременно | 16 на аккаунт, 64 на весь сервис |
| Запросы | 120 в минуту на ключ, вместе с опросом и скачиванием |
| Неудачные авторизации | 30 в минуту на весь сервис, 10 в минуту с одного адреса |
| Хранение результатов | 24 часа после конца задания |
| Обработка | 15 минут с момента, когда задание взято в работу, или для длинного видео в 1,5 раза больше расчётного времени его копий, смотря что дольше |
Некоторые старые файлы QuickTime начинаются не с ftyp, и их не примут: сначала перепакуй, ffmpeg -i in.mov -c copy out.mp4.
Задания API и бота ждут в одной очереди и делаются по одной копии за раз. Одновременно активны не больше 2 заданий API на все аккаунты, остальная очередь оставлена людям в боте. 429 busy значит, что места сейчас нет: подожди Retry-After (30 секунд) и отправь тот же запрос с тем же Idempotency-Key.
Из длинного или очень тяжёлого видео (4K, HDR, несколько минут) одно задание может сделать меньше 10 копий: запрос на большее отклоняется с 422 too_many_copies и error.max_copies. Попроси столько и отправь ещё одно задание на остаток.
Сколько займёт задание, не обещаем: это зависит от заданий перед ним. Обычно несколько минут. Опрашивай и не закладывайся на фиксированное время.
Файлы отдаются 24 часа после конца задания, потом отвечают 410 gone; само задание продолжает отвечать с пустым files. DELETE /v1/jobs/{id}/files удаляет их раньше. Загруженный исходник не хранится.
У каждой ошибки одно и то же тело. Опирайся на code и HTTP-статус: message написан для людей и может меняться. Каждый 429 и 503 несёт Retry-After в секундах.
{"error": {"code": "busy", "message": "the service is at capacity, retry later"}}| Статус | Код | Что значит |
|---|---|---|
400 | bad_request | нет, неверный или повторённый Idempotency-Key или параметр запроса, либо тело не прочиталось |
401 | unauthorized | ключа нет, он неверный, неизвестный или отключён |
402 | insufficient_credits | кредитов меньше, чем copies; в error.balance твой баланс |
403 | forbidden | бот не даёт этому аккаунту новую работу |
404 | not_found | нет такого пути, такого задания у этого ключа или такой выданной копии |
405 | method_not_allowed | путь не принимает этот метод; Allow перечисляет те, что принимает |
408 | timeout | загрузка встала или не уложилась в срок |
409 | in_progress | запрос с этим Idempotency-Key прямо сейчас обрабатывается |
409 | not_finished | DELETE для задания, которое ещё в очереди или в работе |
409 | no_fresh_framing | у этой силы для файла осталось слишком мало нарезок; error.fresh_left показывает остаток для каждой силы |
409 | copy_of_copy | файл сам является копией от сервиса; отправь оригинал или allow_copy=true |
410 | gone | копия истекла или удалена |
413 | too_large | тело больше 95 МиБ |
415 | unsupported_encoding | тело отправлено с Content-Encoding |
416 | range_not_satisfiable | Range выходит за пределы файла |
422 | unsupported_media | не MP4 или MOV, начинающийся с ftyp, нечитаемое видео или превышен лимит по медиа |
422 | too_many_copies | копий больше, чем одно задание может сделать из этого видео; error.max_copies это максимум |
429 | busy | сейчас нет места для загрузки или скачивания; этот запрос ничего не создал |
429 | daily_limit | сегодняшний лимит не покрывает copies |
429 | rate_limited | слишком много запросов с этим ключом или слишком много неудачных авторизаций |
500 | internal | сбой сервера; при загрузке задание могло создаться, повтори с тем же Idempotency-Key |
503 | busy | сервер сейчас не смог решить; при загрузке задание могло создаться, повтори с тем же Idempotency-Key после Retry-After (5 секунд) |
503 | maintenance | новые задания сейчас не принимаются (300 секунд в Retry-After); чтение, скачивание и повтор принятого Idempotency-Key работают |
Эти коды стоят в поле error задания со status failed. У неудачного задания могут быть готовые копии: они в files, и списываются только они.
| Код | Что значит |
|---|---|
interrupted | сервис перезапустился или остановился, пока задание ждало или шло. Видео тут ни при чём: создай новое задание с новым Idempotency-Key |
timeout | задание упёрлось в срок обработки: 15 минут или для длинного видео в 1,5 раза больше расчётного времени, смотря что дольше |
processing_failed | из этого видео не получилось сделать копию |
storage_failed | копию не удалось сохранить |
banned | аккаунт заблокировали до того, как задание пошло |