Imágenes de personas reales con real_person

OfoxAI permite enviar directamente una imagen autorizada de una persona real en una solicitud normal POST /v1/videos. Añade real_person: true en el nivel superior y envía la imagen mediante frame_images o input_references; Ofox aplica un preprocesamiento que protege la privacidad antes de entregar la tarea al proveedor de vídeo.

Así se elimina el registro previo del activo en la plataforma del proveedor. Antes de la primera solicitud no necesitas crear un grupo de activos de persona real en Seedance, pedir al titular que complete la verificación y autorización, esperar el estado Active, obtener un Asset ID y sustituir la imagen por un URI asset://....

Por qué el flujo de Ofox es más sencillo

La documentación oficial de la API de vídeo Seedance 2.0 de BytePlus  indica que no se pueden subir directamente imágenes o vídeos de referencia con rostros humanos reales; se debe usar un activo autorizado. La guía oficial de la biblioteca privada de personas reales  describe la verificación, la comprobación de coherencia, el estado Active y el Asset URI. La guía de Volcano Ark  añade los pasos de invitación, autorización, carga, recepción y obtención del Asset ID.

Ofox simplifica la integración técnica, no la responsabilidad sobre derechos de imagen, consentimiento y uso lícito.

Inicio rápido

curl -X POST https://api.ofox.run/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "La persona camina por un mercado nocturno cinematográfico",
    "real_person": true,
    "input_references": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/person.jpg" }
      }
    ]
  }'

real_person debe estar en el nivel superior. Se requiere al menos una imagen en frame_images o input_references, y ambos campos siguen siendo mutuamente excluyentes. Consulta Crear vídeo para las formas y límites exactos.

Qué ocurre después del envío

1. Ofox valida y preprocesa cada imagen del campo de referencia elegido.
2. La solicitud preprocesada se envía al proveedor de vídeo seleccionado.
3. El proveedor mantiene sus propias comprobaciones de identidad, prevención de deepfakes y seguridad de contenido.

Las entradas adecuadas suelen continuar por el flujo asíncrono normal, pero el preprocesamiento no garantiza la aceptación. Algunas imágenes todavía pueden activar una revisión o un rechazo de persona real. Los trabajos rechazados no se cobran.

Si la imagen aún activa la revisión

Facilita una identificación coherente y vuelve a enviar con real_person: true:

• mantén una sola persona principal clara y reduce otros rostros visibles;
• recorta o reorganiza la composición para que el rostro principal sea grande y no quede en un borde;
• prefiere un rostro claro, frontal, sin obstrucciones y con luz uniforme;
• elimina rostros de fondo, carteles, pantallas, espejos y reflejos cuando sea posible;
• evita ángulos extremos, desenfoque de movimiento, sombras fuertes, máscaras y oclusiones grandes;
• usa una fuente de mayor calidad y simplifica una composición demasiado cargada.

Estos ajustes reducen la ambigüedad, pero no anulan las políticas ni garantizan la aprobación. Si continúa el rechazo, utiliza otra imagen autorizada.

Errores de preprocesamiento que puedes corregir

Si Ofox no puede preprocesar la imagen, devuelve HTTP 400 con error.code: "invalid_request". El final de error.message contiene un código de motivo estable.

Consulta Errores de la API de vídeo para el formato completo.

Documentación relacionada

• Crear vídeo
• Estado del vídeo
• Códigos de error