Avançar 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"

Ficheiros como o exemplo: 1,00 $ 1000 créditos da API · ≈ 107,58 ₽ os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
HeyGen Lipsync e avatares Saída em 4KLipsyncaté 4k #avatar#digital-twin#talking-avatar#text-to-video

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

HeyGen · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

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

audio_url
Largue um ficheiro ou

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

resolution predefinição 720p

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

aspect_ratio predefinição 16:9

Seleção da proporção do vídeo: 'auto' pede ao HeyGen que leia e mantenha a proporção de origem, utilizando '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 predefinição cover

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

output_format predefinição mp4

Seleção do contentor de vídeo, com `webm` a permitir transparência através da remoção automática do fundo; nesse modo, `background` não tem efeito.

predefinição Abigail Sofa Front

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

predefinição Warm Pro Narrator

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

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

Imagem opcional utilizada como sobreposição de marca de á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 este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar 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` identificado por nome, 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 fundo, sobreposição de marca de água e um ficheiro de legendas SRT separado.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
avataropcional
Tipostring | null
PredefiniçãoAbigail Sofa Front
Nome que identifica um avatar elegível para Avatar V.
promptopcional
Tipostring | null
Texto de fala do avatar; obrigatório se `audio_url` for omitido.
voiceopcional
Tipoenum
PredefiniçãoWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 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 apenas sem um `audio_url`.
audio_urlopcional audio
Tipourl · audio
Fonte de sincronização labial fornecida como URL HTTP(S) de um ficheiro de áudio, substituindo a conversão de texto em fala quando presente. Nesse caso, não são utilizados `prompt` nem `voice`.
fitopcional
Tipoenum
Predefiniçãocover
containcover
Escolha o enquadramento do avatar: 'cover' preenche o frame de saída, mas pode cortar o avatar, enquanto 'contain' mostra o avatar inteiro, mas pode adicionar barras laterais.
remove_backgroundopcional
Tipoboolean
Predefiniçãofalse
Remoção do fundo do avatar; disponível apenas para avatares compatíveis com recorte.
backgroundopcional
Tipoobject
Camada de fundo opcional colocada atrás do avatar, exceto com `output_format='webm'`: a saída webm transparente ignora esta definição.
background.typeopcional
Tipoenum
Predefiniçãocolor
colorimage
Tipo de fundo: `color` especifica uma cor hexadecimal sólida, enquanto `image` especifica um URL de imagem.
background.valueopcional
Tipostring
Predefinição#FFFFFF
Conteúdo do fundo: uma cor hexadecimal quando o tipo é `color`, ou um URL HTTP(S) quando o tipo é `image`.
watermarkopcional
Tipoobject
Imagem opcional utilizada como sobreposição de marca de água no vídeo gerado.
watermark.image_urlobrigatório
Tipourl · image
URL HTTP(S) da imagem da marca de água, para sobreposição no vídeo.
watermark.scaleopcional
Tiponumber | null
≤ 2, > 0
Tamanho da marca de água relativo ao vídeo, superior a 0.0 e até 2.0.
watermark.opacityopcional
Tiponumber | null
0 – 1
Nível de transparência da marca de água: 0.0 é totalmente transparente e 1.0 é totalmente opaco.
watermark.placementopcional
Tipoenum
top-lefttop-rightbottom-leftbottom-right
Posição da marca de água no vídeo.
captionopcional
Tipoboolean
Predefiniçãofalse
Controla a geração de um ficheiro SRT de legendas separado associado ao vídeo.
output_formatopcional
Tipoenum
Predefiniçãomp4
mp4webm
Seleção do contentor de vídeo, com `webm` a permitir transparência através da remoção automática do fundo; nesse modo, `background` não tem efeito.
resolutionopcional
Tipoenum
Predefinição720p
720p1080p4k
Predefinição de resolução para a saída gerada.
aspect_ratioopcional
Tipoenum
Predefinição16:9
16:99:164:55:41:1auto
Seleção da proporção do vídeo: 'auto' pede ao HeyGen que leia e mantenha a proporção de origem, utilizando '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
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
video
object {url, content_type, file_name, file_size}Ficheiro de vídeo produzido pelo Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullFicheiro de legendas SRT produzido quando `caption=True`, se o serviço fornecer um.

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