Skip to main content
GET
Список файлов
Возвращает файлы вашего хранилища, от новых к старым. Есть фильтр по типу и полнотекстовый поиск по имени. Удалённые и архивные файлы в выдаче не появляются.

Пример

Параметры

Пагинация — только limit и offset. Ни page, ни totalPages, ни курсора здесь нет.
Допустимые значения type: chat_upload, reference_image, generated_image, generated_video, generated_audio, generated_document, voice_message, avatar, invoice_pdf.
Осмысленны как типы загрузки только chat_upload, reference_image и voice_message — это то, что создаёт эндпоинт загрузки. Остальные значения существуют в фильтре, но появляются из других источников: генерации медиа и служебных операций.

Ответ

200 OK:
total — это не длина текущей страницы. Это счётчик по всему фильтру, поэтому по нему можно посчитать число страниц: ceil(total / limit).
session_id приходит не у всех файлов: у загруженных без него он пуст или отсутствует.

Что дальше

Загрузить файл

Положить файл в хранилище

Метаданные файла

Один файл по идентификатору

Удалить файл

Убрать файл из хранилища

Ошибки

Полная таблица кодов

Авторизации

Authorization
string
header
обязательно

API-ключ в формате sk-.... Альтернативно — заголовок X-Api-Key: sk-... (совместимо с Anthropic SDK).

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

limit
integer
по умолчанию:50
Требуемый диапазон: 1 <= x <= 100
offset
integer
по умолчанию:0
Требуемый диапазон: x >= 0
type
enum<string>

Фильтр по типу. Неизвестное значение игнорируется.

Доступные опции:
chat_upload,
reference_image,
generated_image,
generated_video,
generated_audio,
generated_document,
voice_message,
avatar,
invoice_pdf

Полнотекстовый поиск по имени файла.

Ответ

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

assets
object[]
обязательно
total
integer
обязательно

Всего файлов по фильтру, без учёта страницы.