Skip to main content
POST
Загрузить файл

Способы загрузки

Storage API поддерживает два способа загрузки файлов:
  1. Multipart/form-data — загрузка файла напрямую
  2. Base64 — загрузка закодированного файла в JSON

Параметры

Политики хранения

Политика TEMP_GENERATION (7 дней) применяется автоматически к результатам AI генераций через Media API и не может быть задана вручную.

Примеры

Ответ (200)

Авторизации

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

API ключ передаётся в заголовке: Authorization: Bearer <SPESHU_AI_API_KEY>

Тело

Загрузка файла через multipart/form-data

file
file

Файл для загрузки

externalUserId
string

ID внешнего пользователя

Пример:

"user_123"

storagePolicy
enum<string>

Политика хранения

Доступные опции:
TEMP_UPLOAD,
PERMANENT
Пример:

"TEMP_UPLOAD"

Ответ

200 - application/json
id
string
обязательно

ID файла

Пример:

"file_123abc"

fileType
string
обязательно

Тип файла (IMAGE, VIDEO, AUDIO)

Пример:

"IMAGE"

mimeType
string
обязательно

MIME-тип файла

Пример:

"image/jpeg"

source
string
обязательно

Источник файла (USER_UPLOAD, AI_GENERATION)

Пример:

"USER_UPLOAD"

storagePolicy
string
обязательно

Политика хранения (TEMP_UPLOAD, TEMP_GENERATION, PERMANENT)

Пример:

"TEMP_UPLOAD"

url
string
обязательно

URL файла

Пример:

"https://s3.speshu.ai/f/211837/2026/01/t_c2446f3cf93ac9f5.png"

size
number
обязательно

Размер файла в байтах

Пример:

154832

createdAt
string<date-time>
обязательно

Дата создания

Пример:

"2025-01-03T12:00:00.000Z"

updatedAt
string<date-time>
обязательно

Дата обновления

Пример:

"2025-01-03T12:00:00.000Z"

externalUserId
object | null

ID внешнего пользователя клиента (для группировки файлов)

Пример:

"external_user_456"

expiresAt
object | null

Дата истечения срока действия файла

Пример:

"2025-01-03T14:00:00.000Z"