runwayml_character_performance

Especificações técnicas de runwayml-character-performance

O que é runwayml-character-performance?

runwayml-character-performance é o identificador de plataforma da CometAPI para o fluxo de geração de desempenho de personagem da Runway, comumente descrito pela Runway como Act-Two. O modelo foi criado para animar um personagem a partir de um clipe de atuação humana: você fornece um vídeo de alguém atuando, além de uma imagem ou um vídeo do personagem, e o sistema transfere movimento facial, expressão, sincronização de fala e movimento corporal para uma tomada gerada do personagem.

Este modelo foi projetado para fluxos de criação que precisam de animação rápida de personagens sem um setup tradicional de captura de movimento. A Runway o descreve como uma forma de dar vida aos personagens com movimento, fala e expressão realistas, além de oferecer suporte a personagens não humanos e estilos visuais variados. Quando o personagem-alvo é uma imagem estática, o sistema também pode sintetizar movimento de ambiente para deixar a tomada mais natural.

Na CometAPI, essa capacidade é exposta por meio do endpoint de desempenho de personagem da Runway, tornando-o adequado para equipes de produto, ferramentas criativas, pipelines de prototipagem e fluxos de mídia automatizados que desejam acesso programável à animação de personagens dirigida por desempenho. (cometapi.com)

Principais recursos de runwayml-character-performance

• Transferência de desempenho: Mapeia a atuação de uma pessoa de um vídeo de origem para um personagem-alvo, incluindo movimento facial, expressões e movimentos corporais mais amplos.
• Entrada de personagem flexível: Aceita imagem ou vídeo do personagem, oferecendo aos desenvolvedores diferentes trade-offs entre controle de movimento e preservação da cena.
• Controle de gestos para personagens baseados em imagem: Ao usar uma imagem do personagem, o modelo pode transferir gestos e poses corporais do clipe de atuação, permitindo animação mais expressiva.
• Animação de imagens sensível à cena: Para entradas de personagem em imagem estática, o sistema adiciona automaticamente movimento de ambiente ou semelhante ao de câmera para evitar que o resultado pareça estático.
• Fluxo que preserva o vídeo do personagem: Quando a entrada do personagem é um vídeo, o resultado gerado mantém o sujeito, a cena e o movimento de câmera originais, aplicando a transferência de desempenho facial.
• Expressividade facial ajustável: Suporta controles de intensidade de expressão, permitindo equilibrar uma transferência de atuação mais forte com estabilidade e consistência visual.
• Opções de saída adequadas à produção: Suporta múltiplas proporções e resoluções comuns a 24 FPS, tornando-o utilizável para formatos landscape, retrato, quadrado e cinematográficos para redes sociais/vídeo.
• Otimização para animação de formato curto: Ideal para clipes curtos, com mínimo de 3 segundos e suporte de até 30 segundos, atendendo a anúncios, clipes sociais, trechos de diálogo, previs e cenas de protótipo.

Como acessar e integrar runwayml-character-performance

Passo 1: Cadastre-se para obter a chave de API

Faça login na CometAPI. Se ainda não for usuário, registre-se primeiro. Em seguida, abra seu centro pessoal, crie um token de API e copie sua chave para autenticação nas requisições subsequentes. A CometAPI expõe este modelo por meio de sua infraestrutura de API compatível com Runway. (cometapi.com)

Passo 2: Envie solicitações para a API runwayml-character-performance

Use o endpoint de desempenho de personagem da Runway na CometAPI e defina o campo model como runwayml-character-performance na camada da sua aplicação. O fluxo subjacente da requisição utiliza a rota de desempenho de personagem com entrada JSON para o vídeo de atuação de referência, o ativo do personagem, os controles de movimento e as configurações de saída. (cometapi.com)

curl --location --request POST 'https://api.cometapi.com/runwayml/v1/character_performance' \
  --header 'X-Runway-Version: 2024-11-06' \
  --header 'Authorization: Bearer YOUR_COMETAPI_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "character": {
      "type": "video",
      "uri": "https://your-file-host.example/character.mp4"
    },
    "reference": {
      "type": "video",
      "uri": "https://your-file-host.example/performance.mp4"
    },
    "bodyControl": true,
    "expressionIntensity": 3,
    "seed": 4294967295,
    "model": "runwayml-character-performance",
    "ratio": "1280:720",
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

Passo 3: Recupere e verifique os resultados

Após o envio, processe a resposta da API no seu backend ou aplicativo cliente e verifique se a geração retornada corresponde à duração, enquadramento e qualidade expressiva esperadas. Na prática, você também deve validar se os ativos de entrada seguem as melhores práticas da Runway — filmagens de atuação com um único sujeito bem definidas, rosto visível, enquadramento estável e referências de personagem adequadas — para melhorar a confiabilidade do resultado. (cometapi.com)