Enviar imagens de referência de pessoas reais diretamente com real_person
A OfoxAI permite enviar imagens de referência autorizadas de pessoas reais diretamente em uma requisição comum POST /v1/videos. Basta adicionar real_person: true no nível superior e enviar a imagem por frame_images ou input_references; a Ofox aplica automaticamente um pré-processamento de proteção de privacidade antes de entregar a tarefa ao provedor de vídeo.
Alguns provedores exigem que imagens de referência com rostos reais sejam primeiro cadastradas como ativos e verificadas pela própria pessoa na plataforma deles, como o Seedance; a comparação está em Seedance · Imagens de referência de pessoas reais. Com real_person, essas etapas prévias não são necessárias.
Envie apenas imagens que você tenha o direito legal e a autorização para usar. real_person é uma instrução de processamento, não uma prova de autorização, e não contorna as políticas de conteúdo da Ofox nem do provedor upstream.
Início 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": "Faça a pessoa da imagem caminhar por um mercado noturno cinematográfico",
"real_person": true,
"input_references": [
{
"type": "image_url",
"image_url": { "url": "https://example.com/person.jpg" }
}
]
}'real_person deve ficar no nível superior da requisição. É necessária pelo menos uma imagem em frame_images ou input_references, e os dois campos de referência continuam mutuamente exclusivos. A estrutura e os limites de quantidade estão em Criar tarefa de vídeo.
O que acontece após o envio
- A Ofox valida e pré-processa cada imagem do campo de referência escolhido.
- A requisição pré-processada é enviada ao provedor de vídeo selecionado.
- O provedor continua aplicando as próprias verificações de identidade, anti-deepfake e segurança de conteúdo.
Entradas adequadas normalmente seguem o fluxo assíncrono comum, mas o pré-processamento não garante que o upstream aceite. Algumas imagens ainda podem acionar a revisão de pessoa real ou ser rejeitadas pelo upstream; tarefas rejeitadas não são cobradas.
Quando a imagem ainda aciona a revisão de pessoa real
Torne a pessoa mais fácil de identificar com consistência e envie novamente mantendo real_person: true:
- mantenha uma pessoa principal nítida e reduza a quantidade de outros rostos visíveis na imagem;
- corte ou reorganize o enquadramento para que o rosto principal fique grande o suficiente e longe das bordas;
- prefira um rosto nítido, frontal, sem obstruções e com iluminação uniforme;
- remova ou corte, sempre que possível, rostos de pessoas ao fundo, cartazes, telas, espelhos e reflexos;
- evite ângulos extremos, desfoque de movimento evidente, sombras fortes, máscaras e grandes obstruções;
- use uma imagem original de maior qualidade e simplifique composições muito carregadas.
Esses ajustes reduzem a ambiguidade na identificação, mas não se sobrepõem à política do provedor nem garantem aprovação. Se a rejeição continuar, use outra imagem de referência autorizada.
Erros de pré-processamento que você pode corrigir
Se a Ofox não conseguir pré-processar a imagem de entrada, a requisição retorna HTTP 400 com error.code igual a "invalid_request". O final de error.message traz um código curto de motivo estável:
O objeto de erro completo e o diagnóstico estão em Códigos de erro da API de vídeo.