Ir para o conteúdo

Heygen v5 Digital Twin

Integrar

ID do modelo heygen/avatar5/digital-twin
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/heygen/avatar5/digital-twin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Arquivos como o exemplo: $ 1,00 1.000 créditos de API · ≈ ₽ 107,31 seus arquivos são medidos antes da execução Executar nesta página

Obter chave de API
HeyGen Sincronização labial e avatares Saída em 4KSincronização labialaté 4k #avatar#digital-twin#talking-avatar#text-to-video

Digital twin do Avatar V com saída 4k, WebM transparente, plano de fundo, marca-d'água e legendas SRT

HeyGen · Vídeo

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

Texto da fala do avatar; obrigatório se `audio_url` for omitido.

audio_url
Solte um arquivo ou

Fonte de sincronização labial fornecida como uma URL de arquivo de áudio HTTP(S), substituindo a conversão de texto em fala quando presente. Nesse caso, nem `prompt` nem `voice` são usados.

resolution padrão 720p

Predefinição de resolução para a saída gerada.

aspect_ratio padrão 16:9

Seleção da proporção do vídeo: 'auto' pede ao HeyGen para ler e manter a proporção da fonte, usando '16:9' se não conseguir. As opções explícitas são '16:9', '9:16', '4:5', '5:4' e '1:1'.

Avançado fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit padrão cover

Escolha o enquadramento do avatar: 'cover' preenche o quadro de saída, mas pode cortar o avatar, enquanto 'contain' mostra o avatar inteiro, mas pode adicionar barras laterais.

output_format padrão mp4

Seleção do contêiner de vídeo, com `webm` habilitando transparência por meio da remoção automática do plano de fundo; nesse modo, `background` não tem efeito.

padrão Abigail Sofa Front

Nome que identifica um avatar elegível para Avatar V.

padrão Warm Pro Narrator

Seleção da voz do avatar por nome para conversão de texto em fala; aplica-se somente sem um `audio_url`.

Camada de plano de fundo opcionalmente colocada atrás do avatar, exceto com `output_format='webm'`: a saída webm transparente ignora essa configuração.

Imagem opcional usada como sobreposição de marca d'água no vídeo gerado.

POST /run/heygen/avatar5/digital-twin?wait=20 cotação → $ 1,00
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/heygen/avatar5/digital-twin?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Heygen v5 Digital Twin

Cria um vídeo de avatar falante a partir de texto (`prompt` e `voice`) ou de um `audio_url` para sincronização labial. Selecione um `avatar` nomeado, um modo `fit` de contain ou cover e uma resolução de 720p, 1080p ou 4k. `output_format` pode ser mp4 ou webm; webm é transparente. As opções incluem composição de plano de fundo, sobreposição de marca-d'água e um arquivo de legendas SRT separado.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
avataropcional
Tipostring | null
PadrãoAbigail Sofa Front
Nome que identifica um avatar elegível para Avatar V.
promptopcional
Tipostring | null
Texto da fala do avatar; obrigatório se `audio_url` for omitido.
voiceopcional
Tipoenum
PadrãoWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 a maisAndrewSpuds Oxley Grace ElderHelenCanyon RiversDerya - Lifelike - Excited 🤩Mellow MarcusJack Sterling - Broadcaster 🎙️Brenda - UGC - 1.mp4ReidReaganTerryJennyRadio RickDeniseTim in car - Excited 🤩IskanderThompsonDelicate Daisy - Excited 🤩KingstonGeorge UGC 1Bold BlakeJaneExpressive EvanMarianne - IAAaronModern Recipe Host - Voice 1WillowCute Chloe - Friendly 😊RafaelJune - LifelikeCrisp ChloeSlick SimonNassim - InformativeBaritone BenMaxwellEllie Faye - Excited 🤩MilaniFeisty Fiona - Excited 🤩Professor DeanRose - UGC - 1.mp4ShonaHudson WilderAnn - IAAlastair KensingtonOxleyChristinaAndrew Rizz PeytonGerardo - OutdoorChloe - LifelikeStephanieAnthony - IASignal - Voice 1LucaLisa - Voice 1T.W.TuckerJack Sullivan - Serious 😐WinterMireia - LifelikeGeorgiaStellaMasha - LifelikeCharming Charles - Friendly 😊SerenityAnnie - ExcitedRalphBethanyDominicMason FinnLeenaVeteran VictorTamaraNik PublicCalm ChloeSevikReillyRaulImposing IanRelaxed RayDexter - ProfessionalRelaxed RickEdwinRupert BlackwoodGinnyHope
Seleção da voz do avatar por nome para conversão de texto em fala; aplica-se somente sem um `audio_url`.
audio_urlopcional audio
Tipourl · audio
Fonte de sincronização labial fornecida como uma URL de arquivo de áudio HTTP(S), substituindo a conversão de texto em fala quando presente. Nesse caso, nem `prompt` nem `voice` são usados.
fitopcional
Tipoenum
Padrãocover
containcover
Escolha o enquadramento do avatar: 'cover' preenche o quadro de saída, mas pode cortar o avatar, enquanto 'contain' mostra o avatar inteiro, mas pode adicionar barras laterais.
remove_backgroundopcional
Tipoboolean
Padrãofalse
Remoção do plano de fundo do avatar; disponível somente para avatares compatíveis com recorte.
backgroundopcional
Tipoobject
Camada de plano de fundo opcionalmente colocada atrás do avatar, exceto com `output_format='webm'`: a saída webm transparente ignora essa configuração.
background.typeopcional
Tipoenum
Padrãocolor
colorimage
Tipo de plano de fundo: `color` especifica uma cor hexadecimal sólida, enquanto `image` especifica uma URL de imagem.
background.valueopcional
Tipostring
Padrão#FFFFFF
Conteúdo do plano de fundo: uma cor hexadecimal quando o tipo é `color` ou uma URL HTTP(S) quando o tipo é `image`.
watermarkopcional
Tipoobject
Imagem opcional usada como sobreposição de marca d'água no vídeo gerado.
watermark.image_urlobrigatório
Tipourl · image
URL HTTP(S) da imagem da marca d'água, para sobreposição no vídeo.
watermark.scaleopcional
Tiponumber | null
≤ 2, > 0
Tamanho da marca d'água em relação ao vídeo, maior que 0.0 e até 2.0.
watermark.opacityopcional
Tiponumber | null
0 – 1
Nível de transparência da marca d'água: 0.0 é totalmente transparente e 1.0 é totalmente opaca.
watermark.placementopcional
Tipoenum
top-lefttop-rightbottom-leftbottom-right
Posição da marca d'água no vídeo.
captionopcional
Tipoboolean
Padrãofalse
Controla a geração de um arquivo SRT de legendas separado que acompanha o vídeo.
output_formatopcional
Tipoenum
Padrãomp4
mp4webm
Seleção do contêiner de vídeo, com `webm` habilitando transparência por meio da remoção automática do plano de fundo; nesse modo, `background` não tem efeito.
resolutionopcional
Tipoenum
Padrão720p
720p1080p4k
Predefinição de resolução para a saída gerada.
aspect_ratioopcional
Tipoenum
Padrão16:9
16:99:164:55:41:1auto
Seleção da proporção do vídeo: 'auto' pede ao HeyGen para ler e manter a proporção da fonte, usando '16:9' se não conseguir. As opções explícitas são '16:9', '9:16', '4:5', '5:4' e '1:1'.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador esteja autorizado.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "heygen/avatar5/digital-twin",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1000,
    "usd": "1.00",
    "charged": 1000,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "caption_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
video
object {url, content_type, file_name, file_size}Arquivo de vídeo produzido pelo Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullArquivo de legendas SRT produzido quando `caption=True`, se o serviço fornecer um.

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/heygen/avatar5/digital-twin.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt