Референсы с реальными людьми и `real_person`

OfoxAI позволяет напрямую отправить разрешённое изображение реального человека в обычном запросе POST /v1/videos. Добавьте real_person: true на верхнем уровне и передайте изображение через frame_images или input_references; перед отправкой задачи видеопровайдеру Ofox выполнит предварительную обработку с защитой приватности.

Это исключает предварительную регистрацию ассета на стороне провайдера. До первого запроса не нужно создавать в Seedance группу ассетов человека, просить его пройти проверку личности и выдать разрешение, ждать статуса Active, получать Asset ID и заменять исходное изображение URI вида asset://....

Отправляйте только те изображения, на использование которых у вас есть законное право и необходимое согласие. real_person — инструкция обработки, а не доказательство согласия; она не обходит правила Ofox или вышестоящего провайдера.

Почему процесс Ofox проще

В официальной документации BytePlus Seedance 2.0 Video API сказано, что референсные изображения и видео с лицами реальных людей нельзя загружать напрямую — требуется разрешённый ассет. Официальное руководство по приватной библиотеке реальных людей описывает проверку личности, сверку ассета, статус Active и Asset URI. Руководство Volcano Ark также перечисляет приглашение, подтверждение и разрешение, загрузку, приём ассета и получение Asset ID.

Шаг	Прямой Seedance 2.0 API	Ofox Video API
До первого запроса	Создать группу, пройти проверку и выдать разрешение, загрузить и проверить ассет, получить Asset ID	Предварительная регистрация у провайдера не нужна; используйте изображение, на обработку которого у вас есть разрешение
Значение референса	Активный разрешённый ассет `asset://<asset_id>`	URL изображения или `data:` URI в `frame_images` либо `input_references`
Параметр запроса	Использовать одобренный Asset URI	Добавить `"real_person": true` на верхнем уровне

Ofox упрощает техническую интеграцию, но не снимает ответственность за право на изображение, согласие и законное использование.

Быстрый старт


curl -X POST https://api.ofox.io/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 проверяет и предварительно обрабатывает каждое изображение выбранного поля.
Обработанный запрос отправляется выбранному видеопровайдеру.
Провайдер по-прежнему применяет собственные проверки личности, защиты от дипфейков и безопасности контента.

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

Если изображение всё ещё вызывает проверку

Сделайте человека более однозначным для распознавания и повторите запрос с real_person: true:

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

Эти меры снижают неоднозначность, но не отменяют правила провайдера и не гарантируют одобрение. При повторном отказе используйте другое разрешённое изображение.

Исправляемые ошибки предварительной обработки

Если Ofox не может обработать изображение, API возвращает HTTP 400 и error.code: "invalid_request". В конце error.message находится стабильный код причины.

Код причины	Исправление
`bad_data_uri`	Исправить некорректный `data:` URI или base64
`download_failed`	Обеспечить загрузку URL без ошибок соединения, тайм-аута или доступа
`unreachable`	Использовать URL с успешным HTTP-статусом
`not_image`	Передать поддерживаемое декодируемое изображение
`too_large`	Уменьшить файл, размеры в пикселях или число изображений в запросе

Полный формат приведён в разделе Ошибки Video API.

Референсы с реальными людьми и real_person