ToAPIsToAPIs
Файлы пользователя

Список файлов пользователя

Постраничное чтение зарегистрированных файлов текущего аккаунта

GET
/api/v1/user/file

Для пользователей из материкового Китая: используйте https://api.toapis.cn в качестве эндпоинта (Base URL). Замените https://api.toapis.com на https://api.toapis.cn во всех примерах этого документа.

Поведение

Возвращает зарегистрированные файлы аккаунта по убыванию времени создания, затем ID. Незарегистрированные исторические объекты хранилища не входят в охват. Ответ не содержит URL скачивания, путей хранения или промптов. Связь с задачей может появиться позднее.

Возвращаются только data.items, data.next_cursor, без has_more, meta и общего количества. Непустой next_cursor передавайте без изменений как cursor следующего запроса. Последняя страница возвращает "", пустой список возвращает []. Курсор привязан к аккаунту; подмена или чужой курсор дают 400. Поддерживаются только limit и cursor, без фильтров по времени и состоянию удаления.

Аутентификация

Authorizationstringзаголовокобязательно

Используйте системный токен доступа: Bearer YOUR_SYSTEM_ACCESS_TOKEN. Ключи моделей не принимаются, X-User-Id не нужен. Доступны только файлы и настройки текущего аккаунта, без объединения данных субаккаунтов.

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

limitintegerзапроспо умолчанию: 50

Элементов на странице. По умолчанию 50, диапазон 1-100.

cursorstringзапрос

Непустой next_cursor предыдущей страницы. На первой странице опустите; пустая строка означает конец.

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

curl --request GET \
  --url 'https://api.toapis.com/api/v1/user/file?limit=50' \
  --header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'
import requests

response = requests.get(
    "https://api.toapis.com/api/v1/user/file?limit=50",
    headers={"Authorization": "Bearer YOUR_SYSTEM_ACCESS_TOKEN"},
    timeout=30,
)
response.raise_for_status()
print(response.json())
const response = await fetch("https://api.toapis.com/api/v1/user/file?limit=50", {
  method: "GET",
  headers: { Authorization: "Bearer YOUR_SYSTEM_ACCESS_TOKEN" },
  signal: AbortSignal.timeout(30_000),
});
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
console.log(await response.json());

Поля ответа

Данные примеров вымышлены. Общий формат ответа см. в разделе Подключение.

data.itemsobject[]

Файлы страницы, либо [] при пустом результате.

data.items[].idstring

ID файла для удаления одного файла.

data.items[].sourcestring

Источник регистрации, например task_result, upload, private_asset.

data.items[].task_kindstring | null

Необязательный вид задачи, например generation или export.

data.items[].task_idstring | null

Связанная задача, либо null до привязки.

data.items[].mime_typestring | null

Тип MIME, либо null, если неизвестен.

data.items[].size_bytesinteger | null

Размер в байтах, либо null, если неизвестен.

data.items[].created_atstring

Время создания файла, не регистрации.

data.items[].delete_statestring

none: не в очереди; pending: ожидание; deleting: удаление; blocked: блокировка; deleted: только исторические записи. Список не хранит полную историю удалений.

data.next_cursorstring

Курсор следующей страницы, пустая строка на последней.

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

{
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "id": "123",
        "source": "task_result",
        "task_kind": "generation",
        "task_id": "task_example_01",
        "mime_type": "image/png",
        "size_bytes": 204800,
        "created_at": "2026-11-01T08:00:00Z",
        "delete_state": "none"
      }
    ],
    "next_cursor": ""
  }
}

Ошибки

Неверные limit, cursor или параметры запроса возвращают 400. Временная недоступность чтения файлов возвращает 503.

Общие правила авторизации, лимитов и ошибок см. в разделе Подключение.