Создать заметку

POST/api/v1/pastes

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

Текст, Markdown или код с подсветкой. Доступ, срок, пароль и одноразовое открытие — как у файлов; без них действуют настройки аккаунта.

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

curl -X POST "https://lac.pics/api/v1/pastes" \
  -H "Authorization: Bearer lac_api_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "console.log(\"hello\");",
  "format": "code",
  "language": "javascript",
  "visibility": "unlisted"
}'

Тело запроса

application/jsonобязательный

textstringобязательный
Текст заметки, 1–200 000 символов.
длина 1–200 000
formatstring
plain — текст, markdown — Markdown, code — код с подсветкой.
значения: "plain" "markdown" "code"
по умолчанию "plain"
languagestring
Язык подсветки для формата code; для текста и Markdown не используется.
значения: "text" "javascript" "typescript" "json" "python" "bash" "css" "xml" "sql" "rust" "go" "c" "cpp" "csharp" "yaml"
по умолчанию "text"
tagsмассив string
До 10 тегов по 1–32 символа: NFKC, без крайних пробелов, повторы и регистр схлопываются. При изменении: не передал — теги остаются, пустой массив — очищает.
до 10 элементов · без повторов
titlestring
Название, до 180 символов.
не длиннее 180
visibilitystring
private — только ты; unlisted — все, у кого есть ссылка; public — ещё лента и профиль, нельзя вместе с oneTime (400 ONE_TIME_NOT_PUBLIC). Не передано при создании — настройка аккаунта; при изменении — доступ прежний.
значения: "private" "unlisted" "public"
ttlstring
Срок хранения от момента запроса: day, week, month или forever — без срока. После него ссылка перестаёт открываться, зашифрованные данные удаляются в фоне.
значения: "forever" "day" "week" "month"
passwordstringтолько в запросе
8–128 символов. Пустая строка снимает пароль, без поля пароль не меняется. Хранится как Argon2id и не возвращается; смена закрывает доступ тем, кто уже открывал. В ленте, профилях и альбомах другие видят такой файл закрытой карточкой.
не длиннее 128 · шаблон ^(?:[\s\S]{8,128})?$
oneTimeboolean
Файл откроет только первый гость — не дольше 10 минут, включая перемотку видео. Твой просмотр и запросы GET/HEAD ссылку не тратят. Нельзя вместе с public; в ленте, профилях и альбомах такой файл не показывается.
по умолчанию false

Ответы

201СозданоCreated
- 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
    Имя.
- contentContent
  Файл.
  то же, что Content выше
400Некорректный запросONE_TIME_NOT_PUBLIC
401Нужен действующий ключ
403Нет права или функции тарифа
404Не найдено
409Конфликт
410Файл удалён или истёк
413Слишком большой файл или нет места
429Слишком много запросов
503Сервис занят или недоступен

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

201 · application/json

{
  "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"
  }
}

Коды ошибок

Код	Статус	Текст
`ONE_TIME_NOT_PUBLIC`	400	Одноразовый файл нельзя опубликовать в ленте и профиле. Выбери доступ по ссылке или отключи одноразовую ссылку.

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