Ir al contenido

Heygen · Avatar4 · Image to Video

Integrar

Id del modelo heygen/avatar4/image-to-video
# 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/avatar4/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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 Sincronización labialhasta 1080p #image-to-video

Anima una sola foto de un rostro para crear un avatar parlante, con estilos de habla estables o expresivos

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 que pronunciará el avatar.

•obligatorio image_url
Suelta un archivo o

Fuente de animación proporcionada como URL de imagen; elige una imagen con un rostro claramente visible.

audio_url
Suelta un archivo o

Audio de sincronización labial proporcionado mediante URL de archivo, que tiene prioridad sobre el prompt y la voz cuando está presente.

resolution predeterminado 720p

Valor preestablecido de resolución para el video: 360p, 480p, 540p, 720p o 1080p.

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 talking_style · voice · expression · caption · enable_safety_checker · background
talking_style predeterminado stable

Estilo de animación del habla: 'stable' mantiene el movimiento al mínimo, mientras que 'expressive' añade más animación.

Nombre de voz utilizado para seleccionar la voz del avatar.

Expresión mostrada en el rostro.

Configuración del fondo.

POST /run/heygen/avatar4/image-to-video?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/avatar4/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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 · Avatar4 · Image to Video

Convierte una imagen con un rostro claro en un video de avatar parlante. Proporciona un `prompt` con el texto que debe pronunciar y un nombre de `voice`, o un `audio_url`, que tiene prioridad sobre ambos. `talking_style` alterna entre stable (movimiento mínimo) y expressive. También puedes establecer una expresión, un fondo, subtítulos opcionales y una resolución de 360p a 1080p.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
image_urlobligatorio image
Tipourl · image
Fuente de animación proporcionada como URL de imagen; elige una imagen con un rostro claramente visible.
promptopcional
Tipostring | null
Texto que pronunciará el avatar.
voiceopcional
Tipoenum
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
Nombre de voz utilizado para seleccionar la voz del avatar.
audio_urlopcional audio
Tipourl · audio
Audio de sincronización labial proporcionado mediante URL de archivo, que tiene prioridad sobre el prompt y la voz cuando está presente.
talking_styleopcional
Tipoenum
Predeterminadostable
stableexpressive
Estilo de animación del habla: 'stable' mantiene el movimiento al mínimo, mientras que 'expressive' añade más animación.
expressionopcional
Tipostring | null
Expresión mostrada en el rostro.
backgroundopcional
Tipoobject
Configuración del fondo.
background.typeopcional
Tipoenum
Predeterminadocolor
colorimagevideo
Selección del tipo de fondo.
background.valueopcional
Tipostring
Predeterminado#FFFFFF
Contenido del fondo: un color hexadecimal cuando el tipo es 'color', o una URL cuando el tipo es 'image' o 'video'.
resolutionopcional
Tipoenum
Predeterminado720p
360p480p540p720p1080p
Valor preestablecido de resolución para el video: 360p, 480p, 540p, 720p o 1080p.
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'.
captionopcional
Tipoboolean
Predeterminadofalse
Controla si el video incluye subtítulos.
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/avatar4/image-to-video",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "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
    }
  },
  "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 resultante.

Más modelos: Sincronización labial y avatares

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