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

Исходные изображения (для редактирования, референсов и видео по кадру) сначала загружаются методом POST /v1/files, затем их id передаётся в генерацию. Так файл проверяется один раз, а повторная загрузка того же файла не создаёт копию.

Требования


Форматы	JPEG, PNG, WebP. Формат определяется по содержимому файла, а не по расширению. HEIC, GIF, SVG и другие отклоняются.
Размер	до 15 МБ
Разрешение	от 16×16 до 24 мегапикселей. Изображение уменьшается до 2048 px по длинной стороне.
Метаданные	EXIF, GPS и другие метаданные удаляются, ориентация применяется автоматически.
Срок хранения	Несколько часов (см. expires_at). Пока файл нужен задаче в очереди, срок продлевается автоматически.
Количество	до 100 активных файлов на аккаунт; старые незанятые файлы вытесняются

Пример

curl -s https://neuronovo.ru/api/v1/files \
  -H "Authorization: Bearer $NEURONOVO_API_KEY" \
  -F "file=@photo.jpg"

Ответ

{
  "id": "cmg4k2l0f0001kz0fx8d3a1bc",
  "object": "file",
  "content_type": "image/webp",
  "bytes": 482113,
  "width": 2048,
  "height": 1365,
  "created_at": "2026-09-28T15:04:11.000Z",
  "expires_at": "2026-09-28T19:04:11.000Z",
  "in_use": false
}

Повторная загрузка того же файла вернёт существующий id с кодом 200. GET /v1/files/{id} — информация о файле, DELETE /v1/files/{id} — удаление (нельзя удалить файл, который ждёт задача в очереди: 409 file_in_use).