Статус обработки

GET/api/v1/media-status

Доступ: Ключ API
Право: content:read

Свежие данные до 25 своих файлов одним запросом — удобно ждать, пока видео из PROCESSING станет READY или FAILED. Чужие и неизвестные id в ответ не попадают.

Пример запроса

curl "https://lac.pics/api/v1/media-status?ids=Xq3u9RkT0bLmA7cV2pWz1eFy,bN4wP8sL2dYh6JtQ0mVc9rKa" \
  -H "Authorization: Bearer lac_api_YOUR_KEY"

Параметры

Строка запроса

idsstringобязательный
Через запятую, до 25 id; чужие id в ответ не попадают.

Ответы

200Готовоobject
- itemsмассив Content
  Файлы.
  Content 40 полей
  - idstringобязательный
    id файла.
  - titlestringобязательный
    Название.
  - tagsмассив stringобязательный
    Теги.
    до 10 элементов · без повторов
  - originalNamestring
    Исходное имя файла.
  - typestringобязательный
    IMAGE, VIDEO, PASTE или FOLDER — папка с кодом.
    значения: "IMAGE" "VIDEO" "PASTE" "FOLDER"
  - mimestringобязательный
    MIME-тип сохранённого файла.
  - pasteFormatstringили null
    Формат заметки.
    значения: "plain" "markdown" "code"
  - pasteLanguagestringили null
    Язык подсветки заметки.
  - folderFilesintegerили null
    У папки с кодом — сколько в ней файлов; у остального null.
    от 1
  - revisionintegerобязательный
    Ревизия текста заметки для правки.
    от 1
  - accessVersionintegerобязательный
    Share access version: 1 for a new file, raised by every change of visibility, password or one-time. From 2 on, url carries it as ?v= so messengers build a fresh link card instead of the one they kept for the previous access.
    от 1
  - sizeinteger · int64обязательный
    Размер в байтах.
  - visibilitystringобязательный
    Доступ: private, unlisted или public.
    значения: "private" "unlisted" "public"
  - allowDownloadbooleanобязательный
    Показывается ли кнопка скачивания.
  - passwordProtectedbooleanобязательный
    Есть ли пароль.
  - oneTimebooleanобязательный
    Одноразовая ли ссылка.
  - consumedAtstring · date-timeили null
    Когда одноразовая ссылка была открыта.
  - readExpiresAtstring · date-timeили null
    До какого момента открывший одноразовую ссылку может смотреть файл.
  - readMaxExpiresAtstring · date-timeили null
    Самый поздний конец доступа по одноразовой ссылке.
  - hasVideoTextboolean
    Есть ли у видео субтитры или расшифровка.
  - videoTextRevisioninteger
    Ревизия текста видео.
    0–2 147 483 647
  - viewsintegerобязательный
    Засчитанные открытия гостями, без повторов в пределах доступа зрителя (обычно сутки). Просмотры владельца не считаются.
    от 0
  - viewLimitintegerили null
    Лимит просмотров (Pro) или null.
    1–1 000 000
  - viewLimitReachedAtstring · date-timeили null
    Когда лимит просмотров исчерпан; null, пока просмотры есть или лимита нет.
  - mediaStatusstring
    Обработка: PROCESSING — идёт, READY — готово, FAILED — не удалась. Воспроизведение и превью — после READY; оригинал владелец может скачать и раньше, с ?download=1.
    значения: "PROCESSING" "READY" "FAILED"
  - mediaErrorstringили null
    Причина, если обработка не удалась.
  - widthintegerили null
    Ширина в пикселях.
  - heightintegerили null
    Высота в пикселях.
  - durationMsintegerили null
    Длительность видео в миллисекундах.
  - videoCodecstringили null
    Кодек видео.
  - hasAudioboolean
    Есть ли звук.
  - previewUrlstringили null
    Адрес зашифрованного превью; доступ — как у самого файла.
  - expiresAtstring · date-timeили null
    Когда файл и ссылка перестанут работать; null — без срока.
  - createdAtstring · date-timeобязательный
    Когда создан.
  - urlstring · uriобязательный
    Ссылка на страницу файла.
  - mediaUrlstringобязательный
    Адрес самого файла.
  - moderationHoldstringили null
    Автопроверка: review — скрыт до решения модератора, blocked — скрыт модератором. Другие видят такой файл как приватный.
    значения: "review" "blocked"
  - favoriteboolean
    В избранном (в списках).
  - ownedboolean
    Свой файл (в списках).
  - authorobject
    Автор.
    3 поля
    idstring
    id автора.
    usernamestring
    Никнейм.
    namestring
    Имя.
400Некорректный запрос
401Нужен действующий ключ
403Нет права или функции тарифа
404Не найдено
409Конфликт
410Файл удалён или истёк
413Слишком большой файл или нет места
429Слишком много запросов
503Сервис занят или недоступен

Пример ответа

200 · application/json

{
  "items": [
    {
      "id": "Xq3u9RkT0bLmA7cV2pWz1eFy",
      "title": "capture",
      "tags": [
        "release"
      ],
      "originalName": "capture.png",
      "type": "IMAGE",
      "mime": "image/png",
      "pasteFormat": null,
      "pasteLanguage": null,
      "folderFiles": 1,
      "revision": 1,
      "accessVersion": 1,
      "size": 482133,
      "visibility": "unlisted",
      "allowDownload": true,
      "passwordProtected": false,
      "oneTime": false,
      "consumedAt": null,
      "readExpiresAt": null,
      "readMaxExpiresAt": null,
      "hasVideoText": false,
      "videoTextRevision": 0,
      "views": 3,
      "viewLimit": null,
      "viewLimitReachedAt": null,
      "mediaStatus": "READY",
      "mediaError": null,
      "width": 1920,
      "height": 1080,
      "durationMs": null,
      "videoCodec": null,
      "hasAudio": false,
      "previewUrl": null,
      "expiresAt": null,
      "createdAt": "2026-09-27T09:30:00.000Z",
      "url": "https://lac.pics/s/Xq3u9RkT0bLmA7cV2pWz1eFy",
      "mediaUrl": "/api/media/Xq3u9RkT0bLmA7cV2pWz1eFy",
      "moderationHold": null,
      "favorite": false,
      "owned": true,
      "author": {
        "id": "cmf8a1x2k0000q7lh3v9w2e4d",
        "username": "alex",
        "name": "Alex"
      }
    }
  ]
}

Коды ошибок

Ответы любого метода с ключом — неверный или истёкший ключ, нет права, частые запросы — в разделе Ошибки.