Создать приватную загрузку

POST/v1/files

Требуемое право: files:write. Квота 10 000 000 000 байт на пользователя суммарно по организациям. PUT по выданной ссылке с точными заголовками; затем complete. Ссылка действует 300 секунд, файл хранится 7 дней. До успешной проверки MIME/размера/SHA-256/AV скачивание запрещено.

Авторизация

Authorizationstringобязательный

Ключ API в заголовке Authorization: Bearer <ключ>. Ключ создаётся в кабинете, подробнее — в разделе Аутентификация.

Тело запроса

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

filenamestringобязательныйдлина 1–180

mime_typestringобязательный

Значения: "image/png" "image/jpeg" "image/webp" "audio/wav" "audio/mpeg" "video/mp4" "application/pdf" "text/plain"

size_bytesintegerобязательный1 … 52428800

sha256stringобязательныйшаблон ^[a-f0-9]{64}$

Ответы

201Успешный ответ

application/json

fileobjectобязательный

Вложенные поля

idstringобязательныйuuid

namestringобязательный

mimeTypestringобязательный

sizeBytesintegerобязательный0 … 9007199254740991

statusstringобязательный

Значения: "quarantined" "scanning" "ready" "rejected" "expired" "processing" "failed"

retentionUntilstringобязательныйdate-time

createdAtstringобязательныйdate-time

uploadobjectобязательный

Вложенные поля

urlstringобязательныйuri

method"PUT"обязательный

headersobjectобязательный

expiresAtstringобязательныйdate-time

ОшибкаОшибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.

application/json

errorobjectобязательный

Вложенные поля

codestringобязательный

messagestringобязательный

request_idstring

typestring

curl --request POST \ --url "https://api.kvantora.ai/v1/files" \ --header "Authorization: Bearer $KVANTORA_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "filename": "<string>", "mime_type": "image/png", "size_bytes": 1, "sha256": "<string>" }'

import os import requests response = requests.post( "https://api.kvantora.ai/v1/files", headers={ "Authorization": f"Bearer {os.environ['KVANTORA_API_KEY']}", }, json={ "filename": "<string>", "mime_type": "image/png", "size_bytes": 1, "sha256": "<string>", }, timeout=120, ) print(response.json())

const response = await fetch('https://api.kvantora.ai/v1/files', { method: 'POST', headers: { Authorization: `Bearer ${process.env.KVANTORA_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "filename": "<string>", "mime_type": "image/png", "size_bytes": 1, "sha256": "<string>" }), }); console.log(await response.json());

{ "file": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "<name>", "mimeType": "<string>", "sizeBytes": 0, "status": "quarantined", "retentionUntil": "2026-09-28T12:00:00Z", "createdAt": "2026-09-28T12:00:00Z" }, "upload": { "url": "https://example.com/file", "method": "PUT", "headers": {}, "expiresAt": "2026-09-28T12:00:00Z" } }