Необходимые cookie-файлы нужны для работы сайта. Аналитические cookie (Яндекс Метрика) — только с вашего согласия. Политика cookie-файлов

Тема оформления
СправочникСправочник APIФайлы

Загрузить документ (multipart, поле file)

Единственный способ загрузить файл, до 50 МиБ: тело всегда идёт через API. Не больше 2 загрузок одновременно на организацию (сверх этого 429 rate_limited); если сервис занят — 503. Оба ответа приходят с Retry-After: 1. Всё тело должно прийти за 120 с без пауз дольше 15 с (иначе 408). Не больше 20 загрузок в секунду на ключ API или пользователя (429). Поддерживает Idempotency-Key. Доступ: ключ API со скоупом runs:write или сессия.

Claude (откроется в новой вкладке)ChatGPT (откроется в новой вкладке)
POST/v1/filesПесочница

Авторизация

Проверяем сессию Кабинета…

Файл

multipart/form-data

Файл не покидает браузер до нажатия «Отправить» и уходит только на api.typizer.ru.

Проверяем сессию Кабинета…

Authorization

headerAuthorizationBearer <token>

Ключ API (tz_live_…). Если операция требует скоупы, они нужны ключу; у сессии есть все скоупы.

Header Parameters

Typizer-Organization?string

Организация, от имени которой выполняется запрос (org_…). По умолчанию сессия действует от имени своей активной организации; ключ API может указать только свою.

Idempotency-Key?string

1–255 печатных символов ASCII, уникальных для каждой задуманной операции. Повтор с тем же ключом и тем же запросом в течение 24 часов возвращает первый результат (Idempotent-Replayed: true); тот же ключ с другим запросом или пока первый ещё выполняется — 409 idempotency_conflict.

Match^[\x20-\x7E]+$
Length1 <= length <= 255

Request Body

multipart/form-data
  1. body
file*file

Документ, не больше 52428800 байт (50 МиБ)

Formatbinary

Response Body

Сохранён

application/json
  1. response
id*string
object*"file"
Value in"file"
filename*string

Имя, под которым файл загружен (очищенное)

mime*string

Тип, определённый по содержимому, — не по имени и не со слов клиента

size_bytes*integer
pages_estimate*|

Сколько страниц прогон, по оценке, оплатит до старта; прогон оплачивает фактическое число

source*string
Value in"api""my""mcp""demo""agent"
expires_at*|

Когда файл будет удалён по сроку хранения файлов организации

Formatdate-time
created_at*string
Formatdate-time
curl -X POST 'https://api.typizer.ru/v1/files' \  -F 'file=string'
Example Response
{  "id": "string",  "object": "file",  "filename": "string",  "mime": "string",  "size_bytes": 0,  "pages_estimate": 0,  "source": "api",  "expires_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z"}

Текущая организация и её сроки хранения

Доступ: ключ API или сессия.

Удалить файл сейчас

Файл сразу пропадает для всех; его хранилище стирается сейчас или, если не вышло, при следующей очистке по сроку хранения. Повторный DELETE того же файла отвечает 404: клиент, повторяющий запрос после потерянного ответа, считает 404 удалением. 503 с Retry-After: 1, если файл на мгновение занят. Доступ: ключ API со скоупом runs:write или сессия.