Imagens de pessoas reais com `real_person`

A OfoxAI permite enviar diretamente uma imagem autorizada de uma pessoa real em uma solicitação normal POST /v1/videos. Adicione real_person: true no nível superior e envie a imagem por frame_images ou input_references; a Ofox aplica um pré-processamento com proteção de privacidade antes de entregar a tarefa ao provedor de vídeo.

Isso elimina o cadastro prévio do ativo na plataforma do provedor. Antes da primeira solicitação, você não precisa criar um grupo de ativos de pessoa real no Seedance, pedir que a pessoa conclua a verificação e autorização, aguardar o estado Active, obter um Asset ID e substituir a imagem por uma URI asset://....

Envie apenas imagens que você tenha o direito legal e a autorização necessária para usar. real_person é uma instrução de processamento, não uma prova de consentimento, e não contorna as políticas de conteúdo da Ofox ou do provedor.

Por que o fluxo da Ofox é mais simples

A documentação oficial da API de vídeo Seedance 2.0 da BytePlus informa que imagens ou vídeos de referência com rostos humanos reais não podem ser enviados diretamente; é preciso usar um ativo autorizado. O guia oficial da biblioteca privada de pessoas reais descreve verificação, conferência de consistência, estado Active e Asset URI. O guia do Volcano Ark também detalha convite, autorização, envio, recebimento e obtenção do Asset ID.

Etapa	API direta do Seedance 2.0	API de vídeo da Ofox
Antes da primeira solicitação	Criar grupo, verificar e autorizar a pessoa, enviar e validar o ativo, obter Asset ID	Sem cadastro prévio no provedor; use uma imagem que você esteja autorizado a processar
Valor de referência	Ativo autorizado e ativo como `asset://<asset_id>`	URL da imagem ou URI `data:` em `frame_images` ou `input_references`
Opção da solicitação	Usar a URI aprovada	Adicionar `"real_person": true` no nível superior

A Ofox simplifica a integração técnica, não a responsabilidade por direitos de imagem, consentimento e uso legal.

Início rápido


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": "A pessoa caminha 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. É necessária pelo menos uma imagem em frame_images ou input_references, e os dois campos continuam mutuamente exclusivos. Consulte Criar vídeo para formatos e limites exatos.

O que acontece após o envio

A Ofox valida e pré-processa cada imagem do campo de referência escolhido.
A solicitação pré-processada é enviada ao provedor de vídeo selecionado.
O provedor continua aplicando suas próprias verificações de identidade, anti-deepfake e segurança de conteúdo.

Entradas adequadas normalmente seguem o fluxo assíncrono, mas o pré-processamento não garante aceitação. Algumas imagens ainda podem acionar revisão ou rejeição de pessoa real. Tarefas rejeitadas não são cobradas.

Se a imagem ainda acionar revisão

Facilite a identificação consistente da pessoa e envie novamente com real_person: true:

mantenha uma pessoa principal clara e reduza outros rostos visíveis;
corte ou reorganize a composição para que o rosto principal fique grande e longe das bordas;
prefira um rosto nítido, frontal, sem obstruções e com iluminação uniforme;
remova rostos no fundo, cartazes, telas, espelhos e reflexos quando possível;
evite ângulos extremos, desfoque de movimento, sombras fortes, máscaras e grandes obstruções;
use uma fonte de maior qualidade e simplifique uma composição muito carregada.

Esses ajustes reduzem a ambiguidade, mas não substituem a política do provedor nem garantem aprovação. Se a rejeição continuar, use outra imagem autorizada.

Erros de pré-processamento corrigíveis

Se a Ofox não conseguir pré-processar a imagem, a API retorna HTTP 400 com error.code: "invalid_request". O final de error.message contém um motivo estável.

Motivo	Correção
`bad_data_uri`	Corrija a URI `data:` ou o base64 malformado
`download_failed`	Permita o download sem falha de conexão, tempo ou acesso
`unreachable`	Use uma URL que retorne status HTTP de sucesso
`not_image`	Forneça uma imagem compatível e decodificável
`too_large`	Reduza o arquivo, as dimensões ou a quantidade de imagens por solicitação

Consulte Erros da API de vídeo para o formato completo.

Imagens de pessoas reais com real_person