u usellm
Войти

Список файлов

Получение списка файлов с фильтрацией и пагинацией

Список файлов

Получение списка файлов с фильтрацией и пагинацией.

Параметры запроса

Пагинация

ПараметрТипПо умолчаниюОписание
pageinteger1Номер страницы (от 1)
limitinteger20Количество записей на странице (1-100)

Фильтрация

ПараметрТипОписание
fileTypestringТип файла: IMAGE, VIDEO, AUDIO
sourcestringИсточник: USER_UPLOAD, AI_GENERATION
storagePolicystringПолитика: TEMP_UPLOAD, TEMP_GENERATION, PERMANENT
externalUserIdstringID внешнего пользователя (макс. 128 символов)

Сортировка

ПараметрТипПо умолчаниюОписание
sortBystringcreatedAtПоле: createdAt, size, expiresAt, externalUserId
sortOrderstringdescНаправление: asc, desc

Пример

curl "https://api.usellm.ru/v1/storage/files?fileType=IMAGE&page=1&limit=10&sortBy=createdAt&sortOrder=desc" \
  -H "Authorization: Bearer <USELLM_API_KEY>"

Ответ (200)

{
  "data": [
    {
      "id": "file_abc123",
      "fileType": "IMAGE",
      "mimeType": "image/png",
      "source": "USER_UPLOAD",
      "storagePolicy": "PERMANENT",
      "url": "https://cdn.usellm.ru/files/file_abc123.png",
      "size": 245760,
      "externalUserId": null,
      "expiresAt": null,
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "totalPages": 5
  }
}