Video generation API: проверка входных материалов до запуска

Короткий ответ: сначала установите происхождение и цель

До загрузки в API свяжите материал с внутренним объектом, владельцем, проектом и заявленной целью. Разделяйте пользовательский файл, материал организации, лицензированный asset и тестовый synthetic пример: у них могут быть разные права и сроки хранения. Не ограничивайтесь полем «я согласен» без следа решения. Сохраните минимальные метаданные о том, кто подтвердил основание, когда и для какого сценария, но не превращайте журнал в копию самого изображения или prompt.

Цель обработки важна не меньше источника. Из одного и того же кадра нельзя автоматически делать рекламный ролик, обучение и публичную публикацию. Опишите, кто увидит результат, где он будет храниться и может ли он быть выгружен. Если сценарий связан с человеком, брендом, чужим произведением или чувствительной категорией, добавьте отдельную проверку и владельца решения. Это не юридическая консультация: договоры, согласия, право и применимость правил должен подтвердить ответственный специалист.

Минимизируйте данные и заранее классифицируйте риск

Собирайте только поля, нужные для проверки: тип материала, источник, проект, выбранный policy path и срок жизни задачи. Не просите загрузить паспорт, полный договор или лишние персональные данные, если для технического решения достаточно подтверждённого статуса. Для файлов используйте лимит размера, разрешённый MIME-type, антивирусный или безопасный анализ в изолированной среде и отдельное хранилище до модерации. Имя файла и EXIF тоже могут содержать персональные сведения.

Набор рисков должен быть понятен команде: изображение узнаваемого человека, несовершеннолетний, чужой логотип, конфиденциальный документ в кадре, запрещённая тема, публичное распространение или неопределённое право на исходник. Автоматический классификатор может подсказать маршрут, но не доказывает право использования и не заменяет человеческое решение в спорном случае. Храните результат классификации как сигнал с версией правила, а не как окончательный факт о человеке или материале.

Политика модели и продуктовые правила проверяются до очереди

Сверьте выбранный model ID, допустимые входы, параметры и ограничения в текущем каталоге и документации. Не переносите свойства одной модели на другую и не обещайте пользователю, что задача обязательно завершится. Правила поставщиков, доступность, модерация и форматы могут измениться; ваша форма должна показывать, что именно пользователь отправляет, и давать понятный отказ при неподтверждённом сценарии.

На сервере применяйте allowlist model ID и параметров, а не передавайте произвольные значения из браузера. Сначала создайте внутреннюю запись «ожидает проверки», затем после пройденной политики поставьте задание в очередь с owner и correlation ID. Клиент не получает ключ RussiaAPI и не вызывает video endpoint напрямую. Если проверка отклонена, удалите временный файл по политике хранения и верните нейтральный код причины без публикации деталей внутренней модели или обходных рекомендаций.

Человек в контуре и безопасный журнал решений

Не каждый случай требует ручного просмотра, но границу нужно задать заранее. Низкорисковые synthetic материалы могут пройти по автоматическому правилу, а неоднозначные или чувствительные — попасть к назначенному reviewer. Reviewer видит минимально необходимый контекст и не должен экспортировать файлы в личные чаты или незащищённые инструменты. Для решения фиксируйте policy version, категорию, время, owner и итог, но не копируйте весь prompt или файл в audit log.

У пользователя должен быть путь оспорить ошибочный отказ без отправки материала повторно в разные каналы. Разделите «не хватает подтверждения», «неподдерживаемый формат» и «запрещённый сценарий»; это снижает бесполезные повторы. Регулярно проверяйте согласованность решений, ложные срабатывания и доступ reviewers. Если правило обновилось, не применяйте его задним числом к уже опубликованному результату без отдельного процесса и уведомления владельца.

Тестовый запуск, хранение и выдача результата

Начните с synthetic или явно разрешённого набора, одного model ID и минимального числа параметров. В staging проверьте MIME-type, маршрут согласия, server-side очередь, обработку статусов, отмену и удаление временных файлов. Отдельно проверьте, что callback не выдаёт результат не тому проекту и что повтор webhook не создаёт вторую ссылку. Результат видео также может быть чувствительным: он наследует ограничения исходного сценария и не должен становиться публичным по умолчанию.

Определите сроки хранения исходника, временного файла, task ID, результата и журнала решения в политике организации и договорных условиях. Не считайте короткую ссылку на результат доказательством отсутствия рисков и не используйте чужие правила retention как правила RussiaAPI. После пилота измеряйте агрегаты: долю принятых, отложенных и отклонённых задач, время проверки и сбои очереди. Эти числа помогают улучшить процесс, но не дают гарантии генерации, правовой чистоты или доступности модели.

Server-side пример

Пример показывает локальную проверку на сервере. Ключи берутся только из окружения; до запуска подтвердите маршрут, model ID и параметры в текущем каталоге RussiaAPI.

const ALLOWED_TYPES = new Set(['image/jpeg', 'image/png', 'image/webp']);

export function prepareVideoInput({ file, projectId, consentState, model }) {
  if (!ALLOWED_TYPES.has(file.mime) || file.size > 10_000_000) throw new Error('unsupported_input');
  if (consentState !== 'confirmed') return { state: 'needs_review', projectId };
  if (!process.env.RUSSIAAPI_VIDEO_MODEL_ALLOWLIST?.split(',').includes(model)) throw new Error('model_not_allowed');
  return { state: 'ready_for_server_queue', projectId, model }; // never expose an API key to the client
}

Проверьте синтаксис через node --check, добавьте аутентификацию своего маршрута и негативные тесты. Не логируйте тело запроса или заголовки только ради отладки.

Границы и безопасный запуск

Это инженерное руководство, а не юридическое заключение и не инструкция по обходу законов, санкций, региональных, платёжных или платформенных ограничений. Не передавайте в тесты персональные данные, коммерческие секреты, upstream-ключи, cookie, пароли или полный заголовок Authorization. Для чувствительных данных подтвердите цель, минимизацию, срок хранения и договорные условия с ответственными специалистами.

Ключ RussiaAPI хранится только в server-side secret store. Разделяйте development, staging и production, ограничивайте доступ и журналируйте лишь безопасные метаданные. Неизвестную функцию, модель, квоту, подпись callback или поле ответа считайте неподтверждёнными, пока не проверите их в текущем разрешённом тестовом контуре.