Перейти к основному содержанию
POST
Загрузите референсный файл и сразу получите публичный URL при успехе; опрос задачи не нужен. Загрузка бесплатна, но баланс аккаунта должен быть положительным. Три endpoint используют общую квоту пользователя: по умолчанию 2000 файлов за 72 часа.
Playground документации не поддерживает загрузку файлов. Используйте примеры cURL, Python или JavaScript. Для JavaScript нужен элемент <input type="file"> с выбранным файлом.

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

string
обязательно
Используйте действующий, включённый и не просроченный APIMart API Key в формате Bearer <token>. Аккаунт не должен быть заблокирован, баланс должен быть положительным. Исчерпание собственной квоты Key не мешает загрузке. Получить Key можно в управлении API Keys.

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

file
обязательно
Передайте один файл с именем в поле file запроса multipart/form-data. Не заменяйте файловую часть JSON, строкой base64 или URL. Другие поля формы игнорируются; если частей file несколько, обрабатывается только первая.Поддерживаемые форматы: MP4 (.mp4), MOV (.mov), WebM (.webm)Максимальный размер по умолчанию: 50MB. Лимиты размера настраиваются. Ориентируйтесь на текущую конфигурацию и значение в ошибке превышения размера.
При использовании cURL --form, Python files или JavaScript FormData клиент сам создаёт Content-Type с boundary. Не задавайте этот заголовок вручную.

Проверка файлов

Тип определяется по содержимому, а не расширению или заявленному MIME. Содержимое должно соответствовать endpoint. Переименование не меняет формат; несовпадение типа возвращает HTTP 400. Проверяется структура контейнера. Поддельные заголовки и повреждённые контейнеры отклоняются. Поддерживаются только форматы ниже; переименование AVI, MKV и других не помогает.

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

HTTP 200 возвращает сведения о файле. url находится в корне JSON, без обёртки data и без ID задачи генерации.
string
Публичный URL для соответствующего параметра референса в API генерации. У моделей остаются собственные ограничения формата, размера, количества и длительности. Успешная загрузка не гарантирует совместимость с моделью.
string
Исходное имя файла.
string
MIME-тип, определённый сервером по содержимому, а не значение клиента.
string
Категория файла. Этот endpoint возвращает video.
integer
Фактический размер в байтах.
integer
Время загрузки в секундах Unix.
object
Необязательные сведения о квоте. Поля ограниченного пользователя перечислены ниже. При отсутствии лимита или временной недоступности статистики структура может отличаться.

Общая квота и частота запросов

Изображения, видео и аудио используют общую квоту пользователя. Несколько Keys одного пользователя не увеличивают её. Окно сдвигается каждый полный час и по умолчанию учитывает успехи за последние примерно 71–72 часа. Некорректные, слишком большие и не сохранённые файлы не расходуют файловую квоту. Обычные ограниченные ответы содержат X-Upload-Quota-Limit, X-Upload-Quota-Remaining и X-Upload-Quota-Reset, соответствующие limit, remaining и reset_at. Reset указан в секундах Unix. Пользователи без лимита получают quota: {"unlimited": true} без этих трёх заголовков. При временно недоступной статистике успешный ответ может не содержать quota. Отсутствие данных не означает нулевую или неограниченную квоту; не загружайте повторно только по этой причине. Исчерпанная файловая квота возвращает HTTP 429, error.type: rate_limit_exceeded, quota с remaining: 0 и Retry-After. Подождите указанное число секунд. Отдельно действует ограничение 1000 запросов на Key за 60 секунд с типом rate_limit_error.

Обработка ошибок

Ошибки находятся в корневом объекте error. Проверяйте HTTP-статус, error.type / error.code и error.message.

Использование URL и хранение

72 часа — окно квоты по умолчанию, а не гарантия срока хранения. Срок зависит от политики хранилища. Сохраняйте оригиналы и своевременно используйте URL для генерации; не считайте ссылки постоянными.

Другие endpoint загрузки