Enviar directamente imágenes de referencia de personas reales con real_person

OfoxAI le permite enviar directamente imágenes de referencia autorizadas de personas reales en una petición normal a POST /v1/videos. Basta con añadir real_person: true en el nivel superior y pasar la imagen mediante frame_images o input_references; Ofox aplica automáticamente un preprocesamiento de protección de la privacidad antes de entregar la tarea al proveedor de vídeo.

Algunos proveedores exigen que las imágenes de referencia con rostros de personas reales se registren primero como material en su plataforma y que la propia persona complete una verificación; es el caso de Seedance. La comparación se describe en Seedance · Imágenes de referencia de personas reales. Con real_person no es necesario completar estos pasos de antemano.

Inicio rápido

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": "La persona de la imagen camina por un mercado nocturno de aspecto cinematográfico",
    "real_person": true,
    "input_references": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/person.jpg" }
      }
    ]
  }'

real_person debe ir en el nivel superior de la petición. frame_images o input_references deben contener al menos una imagen, y estos dos campos de referencia siguen siendo mutuamente excluyentes. La estructura y los límites de cantidad se detallan en Crear una tarea de vídeo.

Qué ocurre después del envío

1. Ofox valida y preprocesa cada imagen del campo de referencia elegido.
2. La petición preprocesada se envía al proveedor de vídeo seleccionado.
3. El proveedor sigue aplicando sus propias comprobaciones de identidad, anti-deepfake y seguridad de contenido.

Las entradas adecuadas suelen continuar por el flujo asíncrono normal, pero el preprocesamiento no garantiza que el proveedor upstream las acepte. Algunas imágenes aún pueden activar la revisión o el rechazo de personas reales del proveedor; las tareas rechazadas no se facturan.

Si la imagen sigue activando la revisión de personas reales

Haga que la persona sea más fácil de identificar de forma estable y vuelva a enviar la petición manteniendo real_person: true:

• conserve una única persona principal claramente visible y reduzca el número de otros rostros en la imagen;
• recorte o reencuadre la imagen para que el rostro principal sea suficientemente grande y no quede pegado al borde;
• prefiera un rostro nítido, de frente, sin obstrucciones y con iluminación uniforme;
• elimine o recorte en lo posible los rostros de personas de fondo, carteles, pantallas, espejos y reflejos;
• evite ángulos extremos, desenfoque de movimiento evidente, sombras marcadas, mascarillas y oclusiones grandes;
• use una imagen original de mayor calidad y simplifique las composiciones demasiado recargadas.

Estos ajustes reducen la ambigüedad en la identificación, pero no anulan las políticas del proveedor ni garantizan la aprobación. Si la imagen sigue siendo rechazada, use otra imagen de referencia autorizada.

Errores de preprocesamiento que puede corregir

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

El objeto de error completo y el método de diagnóstico se describen en Códigos de error de la API de vídeo.

Documentación relacionada

• Crear una tarea de vídeo
• Consultar una tarea de vídeo
• Códigos de error de la API de vídeo