Прямая отправка референсов с реальными людьми через real_person
OfoxAI позволяет напрямую отправить разрешённое изображение реального человека в обычном запросе POST /v1/videos. Достаточно добавить real_person: true на верхнем уровне и передать изображение через frame_images или input_references; перед передачей задачи видеопровайдеру Ofox автоматически выполнит предобработку для защиты приватности.
Некоторые провайдеры требуют, чтобы референсы с лицами реальных людей сначала были зарегистрированы как ассеты на их платформе и прошли проверку личности — например, Seedance; сравнение см. в разделе Seedance · Референсы с реальными людьми. С real_person эти шаги выполнять заранее не нужно.
Отправляйте только изображения, на использование которых у вас есть законное право и согласие. real_person — инструкция по обработке, а не подтверждение согласия; она не обходит правила контента Ofox или upstream-провайдера.
Быстрый старт
curl -X POST https://api.ofox.ai/v1/videos \
-H "Authorization: Bearer $OFOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2.0",
"prompt": "Человек из кадра идёт по кинематографичному ночному рынку",
"real_person": true,
"input_references": [
{
"type": "image_url",
"image_url": { "url": "https://example.com/person.jpg" }
}
]
}'real_person должен находиться на верхнем уровне запроса. В frame_images или input_references должно быть хотя бы одно изображение, и эти два поля референсов по-прежнему взаимоисключающие. Точная структура и лимиты приведены в разделе Создание задачи видео.
Что происходит после отправки
- Ofox проверяет и предобрабатывает каждое изображение в выбранном поле референсов.
- Обработанный запрос отправляется выбранному видеопровайдеру.
- Провайдер по-прежнему выполняет собственные проверки личности, защиты от дипфейков и безопасности контента.
Подходящие входные данные обычно проходят в стандартный асинхронный процесс, но предобработка не гарантирует, что upstream примет задачу. Некоторые изображения всё ещё могут вызвать проверку реального человека на стороне upstream или отказ; отклонённые задачи не тарифицируются.
Если изображение всё ещё вызывает проверку
Сделайте человека легче распознаваемым и повторите отправку, сохранив real_person: true:
- оставьте одного чётко видимого главного человека и уменьшите число других лиц в кадре;
- обрежьте или перекомпонуйте кадр, чтобы главное лицо было достаточно крупным и не находилось у края;
- используйте чёткое фронтальное лицо без перекрытий и с равномерным освещением;
- по возможности уберите или обрежьте лица на заднем плане, плакатах, экранах, в зеркалах и отражениях;
- избегайте крайних ракурсов, заметного смаза, глубоких теней, масок и крупных перекрытий;
- возьмите исходник более высокого качества и упростите перегруженную композицию.
Эти меры снижают неоднозначность распознавания, но не отменяют правила провайдера и не гарантируют прохождение проверки. Если отказ повторяется, используйте другое разрешённое изображение.
Исправимые ошибки предобработки
Если Ofox не может предобработать входное изображение, запрос возвращает HTTP 400 с error.code, равным "invalid_request". В конце error.message указан стабильный код причины:
Полный объект ошибки и способы диагностики см. в разделе Коды ошибок Video API.