Загрузка медиа и результатов

Подписанная загрузка входных файлов и временные ссылки на результат.

Публичный HTTPS-адрес изображения, видео или аудио можно передать напрямую в подходящее поле модели. Загрузка с commit ниже нужна только для локальных файлов. Скачивайте готовый файл напрямую по output.assets[].url, без API-ключа. Срок expiresAt обычно составляет 20 минут и не выходит за пределы 14 дней хранения. Повторный опрос обновит ссылку; download-url необязателен.

API

POST /api/v1/common/upload-url
PUT <uploadUrl>
POST /api/v1/files/{fileId}/commit
GET <output.assets[].url>

Загрузка Base64 через SDK

client.uploadBase64 принимает Data URI либо строку Base64 с указанным contentType и выполняет существующую процедуру загрузки и commit. Передайте полученный URI spicy:// в input. Ограничение составляет 10 MiB для изображений и 100 MiB для аудио и видео; более строгие ограничения модели также действуют. Этот метод не отправляет Base64 напрямую в поле ввода модели.

Загрузка входного файла

POST /api/v1/common/upload-url возвращает fileId и uploadUrl. Выполните PUT с указанным Content-Type, затем вызовите POST /api/v1/files/{fileId}/commit и передайте в input модели только URI spicy:// из ответа. Не используйте uploadUrl или временный путь объекта как input.

Content-Type должен совпадать с подписанным. Проверяйте формат и размер на клиенте. URI привязан к аккаунту и не работает между аккаунтами.

Загрузка результата

Скачивайте готовый файл напрямую по output.assets[].url, без API-ключа. Срок expiresAt обычно составляет 20 минут и не выходит за пределы 14 дней хранения. Повторный опрос обновит ссылку; download-url необязателен.

Полные определения полей приведены в контракте OpenAPI 3.1.

Связанные разделы

Предел для изображений — 10 MiB, для аудио и видео — 100 MiB. Учитывайте меньший max_size_mb из схемы и окончательный maxBytes из разрешения на загрузку. Максимальная длительность — 600 секунд. Commit проверяет реальный формат и может вернуть durationSeconds десятичной строкой, а также width и height. Используйте только spicy://-URI успешного commit: она действует один день.

image/jpeg · image/png · image/webp · image/gif · video/mp4 · video/webm · audio/mpeg · audio/wav