Saltar para o conteúdo principal
O Seedance 2.0 gera vídeo a partir de recursos de referência confiáveis — um rosto, uma roupa, um produto, uma voz. Para manter a geração consistente e em conformidade, essas referências ficam em uma biblioteca de recursos privada na qual o modelo confia no momento da inferência. O OrcaRouter expõe essa biblioteca em /v1/asset. Esta página explica como a biblioteca funciona e o que é exigido. Para os endpoints exatos, os parâmetros e um console de testes, consulte API Reference → Seedance Assets.

​
Como a biblioteca é estruturada

  • Grupo de recursos — um contêiner. Para um grupo de pessoa real, um grupo mapeia para uma pessoa real; para um grupo virtual, é um agrupamento lógico (por exemplo, um personagem).
  • Recurso — um único arquivo (imagem, vídeo ou áudio) dentro de um grupo. Apenas recursos que atingem o status Active podem ser referenciados na geração de vídeo.
Você referencia um recurso pronto em uma solicitação de vídeo como asset://<asset_id>.

​
Dois tipos de grupo

As operações de upload e gerenciamento são idênticas para ambos; eles diferem apenas em como o grupo é criado.
Virtual (AIGC)Pessoa real (LivenessFace)
Usar paraPersonagens fictícios / de IA, adereços, cenasA semelhança de uma pessoa real
Criado porUma chamada direta de criaçãoUma verificação facial única feita por essa pessoa
Por quêSem identidade a protegerDireitos de imagem — o consentimento é capturado na origem
Ambas as bibliotecas exigem Advanced Creation Rights; a cota de capacidade é compartilhada entre elas. A biblioteca de pessoas reais está disponível para contas convidadas.

​
Requisitos de arquivo de recurso

Os recursos são fornecidos como uma URL publicamente acessível (sem upload de arquivo, sem base64). Limites:
TipoFormatosRestrições
Imagemjpeg, png, webp, bmp, tiff, gif, heic/heifproporção (L/A) 0.4–2.5 · 300–6000 px por lado · < 30 MB
Vídeomp4, mov480p/720p/1080p · 2–15 s · proporção 0.4–2.5 · 300–6000 px · total de pixels 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
Áudiowav, mp32–15 s · ≤ 15 MB
Conteúdo de retrato, melhores práticas (para consistência facial):
  • Referência de corpo inteiro: imagem vertical, foto frontal de corpo inteiro da pessoa.
  • Close-up facial: imagem vertical, expressão neutra, enquadrada acima dos ombros, com o rosto preenchendo cerca de dois terços do quadro.
Enviar várias boas referências da mesma pessoa para um único grupo melhora a fidelidade com que o vídeo gerado reproduz o rosto e as roupas dela.

​
Ciclo de vida do recurso (o upload é assíncrono)

O upload de um recurso retorna imediatamente com um asset_id; o arquivo é então pré-processado em segundo plano. Faça polling do recurso até que seu Status estabilize:
  • Processing — ainda em pré-processamento; continue fazendo polling.
  • Active — pronto; use-o na geração de vídeo.
  • Failed — o pré-processamento o rejeitou; inspecione Error (por exemplo, formato/tamanho, um bloqueio de moderação de conteúdo ou — para grupos de pessoas reais — FaceMismatch).
Não há garantia de SLA quanto ao tempo de upload; recursos de vídeo levam mais tempo do que imagens. A URL de download assinada retornada para um recurso é temporária (~12 horas).

​
Fluxo de verificação de pessoa real

Um grupo de pessoa real é criado pela própria pessoa verificando-se uma vez. Seu backend nunca lida com os dados faciais dela — ele apenas orquestra o fluxo:
1

Inicie uma sessão

Seu backend pede ao OrcaRouter para iniciar uma sessão de verificação. Você recebe de volta um link H5 (uma página hospedada de verificação facial) e um session_id.
2

A pessoa se verifica

Você entrega o link H5 ao usuário final. Ele o abre no próprio dispositivo — sem necessidade de login no OrcaRouter — e conclui a verificação facial. Ele autoriza uma vez; depois, novos visuais da mesma pessoa podem ser adicionados ao mesmo grupo sem nova verificação.
3

O grupo é criado

Em caso de sucesso, a página de verificação redireciona o navegador do usuário final de volta a um callback do OrcaRouter (tratado automaticamente), e o novo grupo é registrado para você. Se você passou uma return_url, o usuário retorna à sua página.
4

Faça polling do resultado

Seu backend faz polling da sessão até que status seja success (com o novo group_id) ou failed. Em seguida, você envia recursos e gera vídeo exatamente como em um grupo virtual.
Consistência facial. Quando você envia uma imagem para um grupo de pessoa real, ela é comparada com a referência verificada. Uma pessoa diferente (ou vários rostos em uma imagem) é rejeitada — o recurso é resolvido como Failed / FaceMismatch. O nome e a descrição de um grupo podem ser definidos após a criação por meio da operação de atualização de grupo.

​
Cota

Sua conta tem uma contagem máxima de recursos (padrão de 100, em todos os grupos). Uploads além do limite são rejeitados com 403.

​
Referenciando um recurso na geração de vídeo

Quando um recurso estiver Active, referencie-o por asset://<asset_id> no metadata.content[] da solicitação de vídeo Seedance, e aponte para ele no prompt por tipo + posição ([Image 1], [Video 1], [Audio 1]) — nunca pelo asset id bruto: 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
Próximos passos

  • API Reference → Seedance Assets — cada endpoint, todos os parâmetros e um playground interativo (é aqui que ficam os exemplos de solicitação/resposta).
  • Vídeo Seedance — o endpoint de geração de vídeo que consome esses recursos.