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.
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-ivIntroduçã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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites heygen/avatar-iv | Predefinição— |
Campoinput_references | Tipoarray | RequisitoObrigatório | Valores e limites Número mínimo de elementos: 2 Número máximo de elementos: 2 | Predefinição— |
Campoprompt | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, input_references |
Parâmetromaterial_types | Contratotext, image, audio, video |
Parâmetromaterial_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 →
Exemplos de pedidos
Ailoot Ultra · Vídeo
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
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 |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Aliases
Aliases do modelo
Ailoot Ultra heygen/avatar-iv
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
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