Source: https://ailoot.ai/models/pt-pt/heygen-avatar-iv/ Canonical: https://ailoot.ai/models/pt-pt/heygen-avatar-iv/ Language: pt-pt # HeyGen: Avatar IV [Markdown](https://ailoot.ai/models/pt-pt/heygen-avatar-iv/index.md) · [JSON](https://ailoot.ai/models/pt-pt/heygen-avatar-iv/facts.json) ## [HeyGen: Avatar IV](https://ailoot.ai/models/pt-pt/heygen-avatar-iv/) Avatar IV anima uma fotografia para criar um vídeo falado com sincronização labial, em que a expressão facial e o ritmo dos gestos são guiados pela voz. A HeyGen documenta fluxos com guião ou áudio gravado e controlos de movimento de Photo Avatar para apresentadores realistas ou estilizados. - [**Ailoot Ultra · Vídeo** `POST /v1/videos` `heygen/avatar-iv`](https://ailoot.ai/models/pt-pt/heygen-avatar-iv/#method-0) Sobre o modelo Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo. Avatar IV é o motor de avatares da HeyGen que transforma uma imagem fixa num vídeo falado expressivo. A sua conceção de conversão de áudio em expressão, inspirada na difusão, utiliza o tom, o ritmo e a emoção da voz para orientar movimentos faciais, inclinações da cabeça, pausas e microexpressões. O objetivo é um apresentador ou uma personagem que transmite conteúdo falado com sincronização labial e gestos, em vez de um gerador de cenas de uso geral que cria todo um cenário e uma banda sonora a partir de uma instrução cinematográfica. O fabricante descreve suporte para personagens realistas e estilizadas, incluindo imagens de ângulo oblíquo ou de perfil, rostos de estilo anime e animais de estimação. As personagens baseadas em fotografias funcionam melhor quando os olhos, a boca e a estrutura facial são fáceis de identificar. A HeyGen recomenda uma imagem nítida e bem iluminada, com uma postura natural e as mãos visíveis quando os gestos são importantes. Um rosto muito pequeno, lábios escondidos, máscaras espessas, um bico pronunciado ou proporções muito exageradas podem prejudicar o movimento facial e a sincronização labial. Mantenha o enquadramento de origem adequado à interpretação pretendida. O produtor disponibiliza duas vias de entrada de fala. Um guião escrito é associado a uma voz selecionada; uma faixa de áudio previamente gravada fornece diretamente a voz e o ritmo temporal. Utilize a via de áudio gravado quando a interpretação já estiver definida e a via de guião quando a fala tiver de ser sintetizada. Estas entradas são alternativas na interface documentada. Prepare a redação definitiva, os nomes e a pronúncia antes da animação e preserve o áudio ou o guião com o vídeo devolvido, para que o resultado falado possa ser verificado. O perfil do modelo Avatar IV da HeyGen abrange avatares de estúdio, Digital Twins, Photo Avatars, imagens diretas e sujeitos criados por instrução. Um Photo Avatar reutilizável fornece um sujeito estável para vídeos posteriores, enquanto um fluxo de imagem direta começa na imagem fornecida. O perfil Photo Avatar do produtor oferece instruções de movimento em texto livre e opções de expressividade high, medium ou low, sendo low a predefinição. Conserve o aspeto de avatar e o motor escolhidos ao fazer uma série, para que uma mudança de imagem de origem ou de modelo de renderização não se torne uma alteração despercebida do apresentador. Para orientar o movimento, descreva uma ação corporal visível e a sua qualidade emocional. «Acena suavemente com a cabeça com um sorriso caloroso» dá um gesto e uma expressão; uma saudação breve pode utilizar um aceno amigável com a mão. O fabricante recomenda um gesto principal, opcionalmente acompanhado de uma expressão facial, e não mais de duas orações curtas para uma sequência. Avatar IV gere o ritmo a partir da interpretação, pelo que o guia do Studio não exige um calendário de gestos segundo a segundo. Uma redação específica e concisa é mais fácil de inspecionar do que várias ações concorrentes numa única instrução. O perfil de áudio para vídeo do produtor renderiza até trinta minutos de áudio fornecido por pedido, e os recursos MP3 ou WAV carregados têm um limite de 32 MB. Para uma aula ou gravação mais longa, divida o material em limites coerentes da fala e conserve a ordem original. O ritmo da fala do vídeo final deve seguir o áudio selecionado, em vez de uma estimativa de duração de clipe sem relação com ele. As definições de saída documentadas do produtor incluem 720p ou 1080p e proporções de 16:9, 9:16, 4:5, 5:4 ou 1:1, com uma opção automática que segue as proporções de origem. O ajuste cover pode recortar o sujeito; contain enquadra o sujeito inteiro e pode deixar visível o fundo à sua volta. O fluxo de áudio para vídeo devolve MP4 por predefinição. Para avatares de vídeo, a saída WebM transparente exige suporte de matting, e o produtor aplica a remoção de fundo a essa saída, em vez de a combinar com um novo fundo. Inspecione o enquadramento efetivo e o ficheiro antes de colocar o apresentador numa composição maior. Uma introdução de formação pode utilizar uma imagem legível do apresentador, uma explicação concisa e um gesto contido na instrução principal. Um vídeo explicativo de produto pode conservar o mesmo aspeto de avatar e alterar o guião falado para diferentes funcionalidades. O produtor documenta também ficheiros de legendas opcionais e legendas incorporadas no vídeo; reveja a sua redação e sincronização juntamente com a fala. A renderização é assíncrona na interface do fabricante, pelo que uma resposta de criação e o vídeo concluído são recursos diferentes. Mantenha a gravação acabada e o seu estado de conclusão com o resultado da tarefa. Avatar IV mantém-se distinto do movimento guiado por referências do Avatar V e dos seus controlos separados de predefinições do Studio. É também distinto da geração de cenas de uso geral do HeyGen Video e de uma conversa interativa com avatar em direto. Reveja o movimento da boca renderizado, as mãos visíveis, a expressão facial, as pausas e a redação falada face ao material de origem e ao tom pretendido. A imagem, a pose, a iluminação e as instruções de movimento afetam o resultado; uma animação baseada em fotografia deve ser verificada como uma interpretação gerada, conservando as entradas escolhidas para revisões posteriores. **Ailoot Ultra · Vídeo** `POST /v1/videos` `heygen/avatar-iv` [`heygen/avatar-iv`](https://ailoot.ai/models/pt-pt/#m=heygen%2Favatar-iv&route=Ultra&caller=heygen%2Favatar-iv&fmt=videos) HeyGen /`heygen/avatar-iv` ### Introdução Avatar IV anima uma fotografia para criar um vídeo falado com sincronização labial, em que a expressão facial e o ritmo dos gestos são guiados pela voz. A HeyGen documenta fluxos com guião ou áudio gravado e controlos de movimento de Photo Avatar para apresentadores realistas ou estilizados. Entradas aceites Texto · Imagens · Áudio · Vídeo Resultados Vídeo ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Vídeo** `POST /v1/videos` Entrada `text`, `image`, `audio`, `video` Saída `video` | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites heygen/avatar-iv | Predefinição— | | Campo`input_references` | Tipo`array` | RequisitoObrigatório | Valores e limites Número mínimo de elementos: 2 Número máximo de elementos: 2 | Predefinição— | | Campo`prompt` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— | Parâmetros e ciclo de vida do método | Parâmetro | Contrato | | --- | --- | | Parâmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, input\_references | | Parâmetro`material_types` | Contratotext, image, audio, video | | Parâmetro`material_conditions` | ContratoUtilize URLs reais de conteúdo de recursos multimédia concluídos que pertencem ao utilizador, com as assinaturas devolvidas: uma origem de vídeo para BFL, ou uma origem de imagem e uma de áudio para avatar. É exigida a prova da origem relativa ao proprietário/tipo/bytes., Forneça exatamente uma imagem PNG/JPEG e um recurso de áudio WAV/MP3. O áudio tem, no máximo, 32000000 bytes, com duração superior a 0 e, no máximo, 1800 segundos. | Ciclo de vida: `asynchronous_job_then_owned_outputs` `GET /v1/videos/{request_id}` · id ou polling\_url efetivamente devolvido `GET /v1/videos/{request_id}/content` ### Tarifários ##### Cálculo do custo final As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável. As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado. Modo rápido Não especificado Quando o modo rápido está selecionado Modo flex Não especificado Quando o modo flex está selecionado Esforço máximo de raciocínio Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default) #### Tarifas estimadas para comparação #### Preços por configuração Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas. | Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Condições de faturação | Custo | | --- | --- | --- | --- | --- | --- | | ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Condições de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação **—** / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação **—** / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação **—** / 1K tokens | | ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$0.1** por segundo de vídeo | | ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação **$0.1** estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. | O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/) ### Exemplos de pedidos #### Ailoot Ultra · Vídeo Use dados de entrada reais e guarde o resultado completo ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}" export AILOOT_INPUT_REFERENCES_JSON python3 - <<'PY_REQUEST' import json,os from pathlib import Path request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'} request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON']) Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8') PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o response.bin # Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again. ``` ### Receber e guardar os resultados #### Ailoot Ultra · Vídeo - `GET /v1/videos/{request_id}` - `GET /v1/videos/{request_id}/content` ##### Guardar todos os recursos concluídos GET todos os recursos concluídos ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" : "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}" export AILOOT_STATUS_FILE python3 - <<'PY_REQUEST' import json,os from pathlib import Path from urllib.parse import urlsplit,urljoin f=Path(os.environ["AILOOT_STATUS_FILE"]) if not f.is_file():raise SystemExit("Choose the actual completed status file") r=json.loads(f.read_text()) if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths") urls=[] for x in r["data"]: if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path") u=urljoin("https://api.ailoot.ai",x) z=urlsplit(u) if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status") urls.append(u) Path("asset-urls.txt").write_text("\n".join(urls)+"\n") PY_REQUEST index=0 while IFS= read -r asset_url; do curl --fail-with-body --silent --show-error "$asset_url" \ -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4" index=$((index + 1)) done < asset-urls.txt ``` ##### Guardar todos os resultados concluídos Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido. Conserve a resposta completa e os cabeçalhos, todos os resultados efetivamente produzidos, os identificadores originais devolvidos e todos os campos de utilização. Recupere a operação original sem voltar a enviar o pedido de criação. ##### Se for necessário verificar a resposta original Conserve X-Client-Request-ID, X-Ailoot-Task-Id e o id/polling\_url efetivamente devolvido. Continue a tarefa original; não volte a enviar o pedido de criação. Campos da resposta | Campo | Tipo | | --- | --- | | Campo`id` | Tipo | | Campo`status` | Tipo | | Campo`data[]` | Tipo | | Campo`outputs[]` | Tipo | ### Aliases #### Aliases do modelo **Ailoot Ultra** [`heygen/avatar-iv`](https://ailoot.ai/models/pt-pt/#m=heygen%2Favatar-iv&route=Ultra&caller=heygen%2Favatar-iv&fmt=videos) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`heygen/avatar-iv`](https://ailoot.ai/models/pt-pt/#m=heygen%2Favatar-iv&route=Ultra&caller=heygen%2Favatar-iv&fmt=videos) FAQ · HeyGen: Avatar IV Que entradas e resultados estão disponíveis? `POST /v1/videos` · `heygen/avatar-iv`: `text`, `image`, `audio`, `video` → `video` Que campos utiliza o pedido? `POST /v1/videos` · `heygen/avatar-iv`: `model`, `input_references`, `prompt` Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação. ## A empresa e a sua carteira de projetos A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. ## Compre tokens com desconto. Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens. Subscrição Escolha um plano com desconto para os pedidos regulares. Código promocional até 50% Introduza o código na compra. O preço é recalculado conforme a campanha em vigor. Custos no histórico O modelo, os tokens e o montante são guardados para cada pedido. [Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## Ligue a API ao produto que vende. SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor. Aplicação comercial Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço. Licença de revendedor Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda. Documentos no site A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação. [Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.