Ir al contenido

Heygen v5 Digital Twin

Integrar

Id del 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"

Archivos como el ejemplo: 1,00 $ 1000 créditos de API · ≈ 107,58 ₽ tus archivos se miden antes de la ejecución Ejecutar en esta página

Obtener clave de API
HeyGen Sincronización labial y avatares Salida 4KSincronización labialhasta 4k #avatar#digital-twin#talking-avatar#text-to-video

Gemelo digital Avatar V con salida 4k, WebM transparente, fondo, marca de agua y subtítulos SRT

HeyGen · Vídeo

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

Texto de voz del avatar; es obligatorio si se omite `audio_url`.

audio_url
Suelta un archivo o

Fuente de sincronización labial proporcionada como una URL HTTP(S) a un archivo de audio, que reemplaza la conversión de texto a voz cuando está presente. En ese caso no se usan `prompt` ni `voice`.

resolution predeterminado 720p

Preajuste de resolución para la salida generada.

aspect_ratio predeterminado 16:9

Selección de relación de aspecto del video: 'auto' solicita a HeyGen que lea y conserve la relación de origen, usando '16:9' si no puede hacerlo. Las opciones explícitas son '16:9', '9:16', '4:5', '5:4' y '1:1'.

Avanzado fit · output_format · avatar · voice · remove_background · caption · enable_safety_checker · background · watermark
fit predeterminado cover

Elige el encuadre del avatar: 'cover' rellena el fotograma de salida, pero puede recortar el avatar, mientras que 'contain' muestra el avatar completo, pero puede añadir bandas.

output_format predeterminado mp4

Selección del contenedor de video, donde `webm` permite la transparencia mediante la eliminación automática del fondo; en ese modo, `background` no tiene efecto.

predeterminado Abigail Sofa Front

Nombre que identifica un avatar apto para Avatar V.

predeterminado Warm Pro Narrator

Selección de la voz del avatar por nombre para la conversión de texto a voz; solo se aplica sin `audio_url`.

Capa de fondo colocada opcionalmente detrás del avatar, excepto con `output_format='webm'`: la salida webm transparente ignora esta configuración.

Imagen opcional utilizada como superposición de marca de agua en el video generado.

POST /run/heygen/avatar5/digital-twin?wait=20 cotización → 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"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y se guarda (localStorage) únicamente si marcas Recordar. Obtener una clave de API

Acerca de Heygen v5 Digital Twin

Crea un video de avatar parlante a partir de texto (`prompt` y `voice`) o de un `audio_url` para sincronizar los labios. Selecciona un `avatar` con nombre, un modo `fit` de contain o cover y una resolución de 720p, 1080p o 4k. `output_format` puede ser mp4 o webm; webm es transparente. Las opciones incluyen composición de fondo, superposición de marca de agua y un archivo de subtítulos SRT independiente.

Parámetros

Envía el nombre canónico o el nombre nativo, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
avataropcional
Tipostring | null
PredeterminadoAbigail Sofa Front
Nombre que identifica un avatar apto para Avatar V.
promptopcional
Tipostring | null
Texto de voz del avatar; es obligatorio si se omite `audio_url`.
voiceopcional
Tipoenum
PredeterminadoWarm Pro Narrator
Warm Pro NarratorChill BrianIvyJohn DoeMonika SogamHope Archer BrittneyPatrickDavid CastlemoreMichael CAdam Stone JuniperCassidy Jessica Anne BogartArabella
+86 másAndrewSpuds 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
Selección de la voz del avatar por nombre para la conversión de texto a voz; solo se aplica sin `audio_url`.
audio_urlopcional audio
Tipourl · audio
Fuente de sincronización labial proporcionada como una URL HTTP(S) a un archivo de audio, que reemplaza la conversión de texto a voz cuando está presente. En ese caso no se usan `prompt` ni `voice`.
fitopcional
Tipoenum
Predeterminadocover
containcover
Elige el encuadre del avatar: 'cover' rellena el fotograma de salida, pero puede recortar el avatar, mientras que 'contain' muestra el avatar completo, pero puede añadir bandas.
remove_backgroundopcional
Tipoboolean
Predeterminadofalse
Eliminación del fondo del avatar; disponible solo para avatares compatibles con el recorte del fondo.
backgroundopcional
Tipoobject
Capa de fondo colocada opcionalmente detrás del avatar, excepto con `output_format='webm'`: la salida webm transparente ignora esta configuración.
background.typeopcional
Tipoenum
Predeterminadocolor
colorimage
Tipo de fondo: `color` especifica un color hexadecimal uniforme, mientras que `image` especifica una URL de imagen.
background.valueopcional
Tipostring
Predeterminado#FFFFFF
Contenido del fondo: un color hexadecimal cuando el tipo es `color`, o una URL HTTP(S) cuando el tipo es `image`.
watermarkopcional
Tipoobject
Imagen opcional utilizada como superposición de marca de agua en el video generado.
watermark.image_urlobligatorio
Tipourl · image
URL HTTP(S) de la imagen de marca de agua que se superpondrá al video.
watermark.scaleopcional
Tiponumber | null
≤ 2, > 0
Tamaño de la marca de agua relativo al video, superior a 0.0 y como máximo 2.0.
watermark.opacityopcional
Tiponumber | null
0 – 1
Nivel de transparencia de la marca de agua: 0.0 es completamente transparente y 1.0 es completamente opaca.
watermark.placementopcional
Tipoenum
top-lefttop-rightbottom-leftbottom-right
Posición de la marca de agua dentro del video.
captionopcional
Tipoboolean
Predeterminadofalse
Controla la generación de un archivo de subtítulos SRT independiente que acompaña al video.
output_formatopcional
Tipoenum
Predeterminadomp4
mp4webm
Selección del contenedor de video, donde `webm` permite la transparencia mediante la eliminación automática del fondo; en ese modo, `background` no tiene efecto.
resolutionopcional
Tipoenum
Predeterminado720p
720p1080p4k
Preajuste de resolución para la salida generada.
aspect_ratioopcional
Tipoenum
Predeterminado16:9
16:99:164:55:41:1auto
Selección de relación de aspecto del video: 'auto' solicita a HeyGen que lea y conserve la relación de origen, usando '16:9' si no puede hacerlo. Las opciones explícitas son '16:9', '9:16', '4:5', '5:4' y '1:1'.
enable_safety_checkeropcional
Tipoboolean
Predeterminadotrue
La moderación puede relajarse estableciendo false, siempre que el autor de la llamada esté autorizado.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una carga. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (se cobra por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
video
object {url, content_type, file_name, file_size}Archivo de video producido por Avatar V.
caption_file
object {url, content_type, file_name, file_size} | nullArchivo de subtítulos SRT producido cuando `caption=True`, si el servicio proporciona uno.

Para agentes de IA: esta página en Markdown está en https://doitong.com/es/developers/models/heygen/avatar5/digital-twin.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt