O vídeo gerado por IA se torna muito mais útil quando a pessoa na tela permanece reconhecível de uma cena para outra. Os ativos de humanos reais do AIHubMix fornecem uma maneira baseada em consentimento para usar um rosto aprovado na geração de vídeos do Seedance, mantendo a autorização, o processamento de ativos e a geração como etapas separadas e verificáveis.
Este guia explica o que é vídeo de humanos reais, como funciona o fluxo de trabalho do AIHubMix, por que é útil e como criar um vídeo Seedance 2.5 a partir de um rosto real. Ele também explica a diferença entre a API nativa do Seedance 2.5 e as integrações compatíveis do Seedance 2.0.
O que é Vídeo de Humanos Reais?
Vídeo de humanos reais é um vídeo gerado por IA que usa uma pessoa autorizada como referência de identidade. O modelo pode mudar o cenário, a roupa, a ação, o movimento da câmera, a voz ou o idioma, enquanto preserva a aparência reconhecível da pessoa.
Isso é diferente da geração comum de texto para vídeo. Um prompt de texto descreve o que deve acontecer, mas não identifica de forma confiável uma pessoa real específica. Um ativo de humano real fornece ao modelo uma referência visual aprovada que pode ser reutilizada em vários vídeos.
Aplicações típicas incluem avatares de criadores, apresentadores virtuais, explicadores de produtos, campanhas localizadas, vídeos de treinamento, personagens de marca e conteúdo social de formato curto.
Como Funciona o Fluxo de Trabalho do AIHubMix
O fluxo de trabalho tem cinco etapas principais:
- Criar um grupo de ativos para uma pessoa.
- Pedir à pessoa na imagem para completar o fluxo de autorização.
- Adicionar um retrato e esperar até que o ativo esteja ativo.
- Referenciar o ativo ativo com um
asset://URI. - Enviar uma tarefa de vídeo Seedance e consultar até a conclusão.
A separação é deliberada. A autorização acontece antes da geração, a prontidão do ativo pode ser verificada de forma independente e cada etapa importante expõe um status que sua aplicação pode monitorar.
Por que Usar AIHubMix?
Uma API para o fluxo de trabalho completo
AIHubMix fornece endpoints para grupos de ativos, sessões de verificação, ativos humanos e geração de vídeo assíncrona. A mesma conta e chave de API podem gerenciar todo o pipeline.
Autorização explícita
A pessoa no retrato completa a página de autorização. Isso cria uma etapa clara de consentimento antes que a imagem seja usada como uma referência reutilizável de humano real.
Ativos de identidade reutilizáveis
Depois que uma imagem se torna ativa, as aplicações podem reutilizar seu ID de ativo em várias solicitações de vídeo, em vez de fazer o upload da imagem original toda vez.
Geração pronta para Seedance
O endpoint nativo do Seedance 2.5 suporta referências de texto, imagem, vídeo e áudio, além de controles para duração, resolução, proporção de aspecto e geração de áudio.
Estados observáveis e amigáveis à produção
Sua aplicação pode esperar por verified, active e completed, em vez de adivinhar se uma operação foi concluída. Isso torna as tentativas e o tratamento de erros mais fáceis de implementar.
Tutorial Passo a Passo
Passo 1: Prepare uma chave de API e um retrato
Crie uma chave de API no Console do AIHubMix. Mantenha-a privada. No Terminal, defina-a como uma variável de ambiente:
export AIHUBMIX_API_KEY="sua_chave_api"
Prepare uma URL de imagem HTTPS direta. A URL deve retornar o arquivo de imagem sem login ou cabeçalhos personalizados e deve permanecer disponível enquanto o AIHubMix o processa.
Requisitos recomendados para a imagem:
- JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ou HEIF
- Menos de 30 MB
- Largura e altura maiores que 300 pixels e menores que 6000 pixels
- Proporção de aspecto maior que 0.4 e menor que 2.5
- Um retrato claro da mesma pessoa que completa a autorização
Passo 2: Crie um grupo de ativos de humanos reais
Execute este comando no Terminal:
curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Meu ativo de humano real"}'
Salve o id retornado, que se parece com ag_...:
GROUP_ID="ag_seu_id_de_grupo"
Um novo grupo normalmente começa com pending_auth.
Passo 3: Crie uma sessão de autorização
Use o ID do grupo para solicitar uma sessão de verificação:
curl -sS -X POST \
"https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
-H "Authorization: Bearer $AIHUBMIX_API_KEY"
A resposta contém uma verification_url temporária. Abra essa URL em um navegador e peça à pessoa no retrato para revisar o propósito e completar o fluxo de autorização.
A URL é sensível e temporária. Não a publique, não a comprometa em um repositório e não a inclua em capturas de tela.
Passo 4: Verifique a autorização e o status do grupo
Depois que a pessoa terminar o fluxo no navegador, consulte ambos os recursos:
curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
-H "Authorization: Bearer $AIHUBMIX_API_KEY"
curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
-H "Authorization: Bearer $AIHUBMIX_API_KEY"
Continue apenas quando a sessão de verificação estiver verified e o grupo de ativos estiver active. Uma página de erro do navegador não determina o resultado final; use o status da API.
Passo 5: Adicione o retrato
Envie a URL da imagem direta:
curl -sS -X POST \
"https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: portrait-001" \
-d '{
"url":"https://cdn.example.com/portrait.jpg",
"asset_type":"image",
"client_reference_id":"portrait-001"
}'
Salve o ID do ativo retornado e consulte-o:
ASSET_ID="ast_seu_id_de_ativo"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
-H "Authorization: Bearer $AIHUBMIX_API_KEY"
Use o ativo apenas quando seu status estiver active. creating e processing significam que ele ainda não está pronto.
Passo 6: Gere um vídeo Seedance 2.5
O ativo de humano real pertence a input_references[].url. Ele não deve ser colado no texto do prompt:
curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d "{
\"model\":\"doubao-seedance-2-5-260628\",
\"prompt\":\"Um vlog vertical realista. A pessoa sorri, acena e diz em japonês: やっほー！今日も笑顔でね！ Mantenha o rosto consistente, sincronize o movimento dos lábios, use um movimento natural das mãos e não adicione legendas.\",
\"duration\":5,
\"resolution\":\"720p\",
\"aspect_ratio\":\"3:4\",
\"generate_audio\":true,
\"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
}"
A resposta retorna um ID de tarefa de vídeo. Consulte GET /ai/v1/videos/{id} até que a tarefa esteja completed, então baixe a saída rapidamente porque as URLs de vídeo são temporárias.
Seedance 2.5 e Seedance 2.0
Seedance 2.5 usa o endpoint nativo /ai/v1/videos descrito acima. Integrações mais antigas podem usar o Seedance 2.0 com o protocolo compatível /v1/videos e uma estrutura de conteúdo diferente.
Não misture os dois formatos de solicitação. Antes do uso em produção, verifique o esquema do modelo ao vivo para durações, resoluções, tipos de referência, comportamento de áudio e caminhos de endpoint suportados.
Melhores Práticas de Prompting
Descreva o ambiente, a ação, o tempo, o movimento da câmera, a voz e as restrições. Um prompt forte pode especificar um quimono, flores de cerejeira caindo, uma onda suave, diálogo em japonês, movimento sincronizado dos lábios, movimento natural do cabelo e sem legendas.
Cinco segundos funcionam bem para uma saudação curta. Se o vídeo incluir várias ações ou uma frase longa, use uma duração maior ou encurte o roteiro para que a performance não pareça apressada.
Use uma referência de identidade para um teste simples. Adicione referências adicionais apenas quando o esquema do modelo as suportar e cada ativo pertencer ao mesmo grupo de ativos.
Problemas Comuns
- O grupo não está ativo: aguarde a sessão de verificação se tornar
verifiede o grupo se tornaractive. - O ativo está processando: consulte o ID do ativo original; não crie duplicatas com um novo ID.
- A URL da imagem falha: use uma URL de arquivo HTTPS pública, não um caminho local, página de login ou página de compartilhamento.
- O vídeo rejeita o ativo: confirme que o ativo está
active, pertence à mesma conta e usa o tipo de mídia correto. - O Playground não mostra
asset://: O upload de imagem do Playground e o registro de ativos de humanos reais são fluxos de trabalho separados. Use o campo de referência da API para ativos registrados.
Lista de Verificação Final
- Chave de API configurada com segurança.
- Grupo de ativos criado.
- Autorização da pessoa concluída.
- Status do grupo é
active. - Status do ativo do retrato é
active. - Solicitação de vídeo usa
asset://<asset_id>. - Tarefa de vídeo é consultada até
completed.
Os ativos de humanos reais do AIHubMix oferecem aos desenvolvedores uma maneira prática de construir experiências de vídeo baseadas em consentimento e consistentes em identidade com o Seedance. Comece com um retrato aprovado e um clipe de teste curto, depois expanda o mesmo fluxo de trabalho para ferramentas de criadores, conteúdo de marca e aplicações de produção.
