Documentazione

HeyGen (video)

Generare video con avatar, doppiare un video con sincronizzazione labiale, affidare un montaggio al Video Agent, clonare una voce o creare un avatar — da una pipeline, sul tuo account HeyGen.

HeyGen (video)

L'integrazione HeyGen porta il video nelle tue pipeline: video con avatar a partire da uno script, doppiaggio in un'altra lingua, voci di sintesi. È il tuo account HeyGen: HeyGen ti fattura direttamente, betool non aggiunge né metering né margine.

Cosa puoi farci

NodoEffetto
heygen_generate_videoVideo con avatar a partire da uno script: avatar, voce, formato (16:9, 9:16, 1:1…), risoluzione fino al 4K, velocità, sottotitoli
heygen_translate_videoDoppiaggio di un video in un'altra lingua, con sincronizzazione labiale; sottotitoli SRT opzionali
heygen_video_agentIl Video Agent di HeyGen scrive e monta il video a partire da un'unica istruzione
heygen_generate_speechSola voce di sintesi, senza avatar
heygen_clone_voiceClonazione della voce a partire da una registrazione
heygen_create_avatarCreazione di un avatar — foto, gemello digitale (digital twin) o avatar descritto da un'istruzione
heygen_video_statusMonitoraggio di un video in fase di rendering, e recupero del media una volta pronto

Il rendering di un video richiede tempo: un nodo attende un intervallo configurabile, poi restituisce il controllo. Per essere avvisato al termine del rendering, dichiara il ricevitore heygen_inbound sullo Start di un modello: HeyGen lo chiama quando un video è pronto, la firma viene verificata e i duplicati scartati. Senza webhook, una pipeline pianificata può interrogare heygen_video_status.

I nodi fatturati da HeyGen vengono eseguiti una sola volta, anche in caso di riesecuzione: un video non viene mai pagato due volte.

Consenso. Clonare una voce o creare l'avatar di una persona reale impegna la tua responsabilità: devi disporre del suo consenso. Per questo queste due operazioni esistono solo come nodi, inseriti da un progettista — nessun tool consente a un agente di attivarle da solo.

Tool per l'agente

  • Lettura: heygen.list_avatars, heygen.list_voices, heygen.list_translation_languages, heygen.get_account, heygen.get_video, heygen.get_translation.
  • Scrittura: heygen.generate_video, heygen.generate_speech, heygen.translate_video.

Connessione

  1. Impostazioni → Servizi → HeyGen, scheda Account.
  2. Due modalità:
    • « Accedi con HeyGen » — OAuth 2.0 con PKCE, senza gestire alcuna chiave (disponibile quando l'operatore della piattaforma l'ha attivato);
    • chiave API HeyGen del tuo account (BYO), con avatar e voce predefiniti.

Casi d'uso

  • Video personalizzato — un lead qualificato riceve un breve video con avatar che riprende il suo nome e la sua esigenza.
  • Localizzazione — un video di prodotto doppiato in più lingue, una lingua per nodo.

Il video passa da questi nodi, non dal canale telefonico, che resta solo audio.