HeyGen AI-avatár és UGC videók publikálása közösségi médiára 2026-ban

A HeyGenben készített beszélő AI-avatár és UGC-jellegű videók TikTok-, Instagram Reels-, Facebook Reels-, YouTube Shorts- és LinkedIn-publikálásánál két szabályt nem lehet megkerülni: egyrészt a valósághű beszélő avatárt minden nagy platformon kötelező AI-generáltként megjelölni; másrészt ha API-n keresztül automatizálod a renderelést, a HeyGen webhookja és státusz-végpontja ideiglenes, lejáró aláírt (presigned) MP4 URL-t ad vissza, amelyet lejárat előtt át kell emelni a saját médiatárba. Ha 1080p felbontást és 9:16 képarányt állítasz be, a HeyGen 25 fps-es MP4 fájlja minden hálózaton átmegy a közösségimédia-videóspecifikációs táblánk szerint.

A HeyGen export-specifikációi és a közösségi platformok korlátai

A HeyGen hivatalos fejlesztői dokumentációja (Usage Limits és Digital Twin / Create Video, ellenőrizve: 2026. október 25.) szerint minden avatárt tartalmazó videó 25 képkocka/másodperc (fps) sebességgel készül, 128 és 4096 pixel közötti oldalhosszal, alapértelmezetten 1080p felbontásban (720p és 1080p az Avatar IV és Avatar V motorokon; 4k az Avatar III-on). Egy egyjelenetes avatár-kérés legfeljebb 5000 karakter szkriptet vagy 10 perc (600 másodperc) hangfájlt fogad, jelenetenként legfeljebb 30 perces hosszal (stúdióvideókban legfeljebb 50 jelenettel).

Így illeszkedik a HeyGen kimenete az egyes platformok API-követelményeihez a videó-specifikáció ellenőrzőnk és az AI-generált videók publikálásáról szóló átfogó útmutatónk alapján:

Két beállítással elkerülheted a hibákat: az output_format maradjon mp4 (mert az Instagram Reels, a Facebook Reels és a LinkedIn nem fogad webm-et), az álló videó hossza pedig maradjon 90 másodperc alatt 1080p-ben, ha Facebook Reelsre is kimegy.

Miért kötelező minden valósághű beszélő avatárnál az AI-címke?

A kamerába beszélő, fotórealisztikus AI-avatár pontosan az a kategória, amelyre minden közösségi platform szintetikusmédia-szabályzata készült. Mindkét tipikus HeyGen-munkafolyamatot lefuttattuk az AI-tartalomcímkék szabálytábláján:

Mindkét esetben minden célplatformon kötelező az AI-jelölés. A TikTok közösségi irányelvei kötelezővé teszik a címkét minden valósághű AI-embernél és valódi személy hangját utánzó hangnál; a Meta előírja a fotórealisztikus videónál és a valósághű AI-hangnál is; a YouTube megköveteli, ha valós személy olyat mond, amit nem, vagy ha a jelenet valósághű; 2026. augusztus 2-tól pedig az EU AI Act 50. cikk (4) bekezdése minden szakmai közzétevőt (márkát, ügynökséget, bevételt szerző alkotót) kötelez a deepfake-ek jelölésére.

Tiszta render vs. ráégetett felirat és a safe zone

Amikor a HeyGen befejezi a renderelést, a GET /v3/videos/{video_id} státuszválasz két külön videólinket is adhat:

• video_url: a tiszta, felirat nélküli MP4 (kivéve, ha kifejezetten kértél ráégetési style-t).

• captioned_video_url: a képkockákra ráégetett feliratos MP4, mellette a subtitle_url mezőben a külön .srt feliratfájllal.

Ha 9:16-os álló avatárvideóra égetsz feliratot, sorozatgyártás előtt ellenőrizd egy képkockát az ingyenes safe zone ellenőrzőnkben. A TikTok, az Instagram Reels és a YouTube Shorts az alsó 20–25%-ra teszi a csatornanevet, a leírást és a zenecímet, ami könnyen kitakarja az alulra égetett feliratot.

HeyGen webhook MP4 URL-ek közvetlen bekötése a POST /videos/import végpontba

Akár a 2026. október 31-ig élő POST /v2/video/generate, akár az új POST /v3/videos végpontot használod, a renderelés aszinkron. Amikor a feladat completed állapotba lép (vagy a HeyGen meghívja a callback_url webhookodat az avatar_video.success eseménnyel), a video_url egy korlátozott ideig érvényes, aláírt (presigned) letöltési link.

Ahelyett, hogy egy köztes szerverre töltenéd le és onnan töltenéd fel újra a fájlt, egy n8n HTTP Request lépésből vagy saját backendből közvetlenül átadhatod a HeyGen presigned URL-jét az Uplonic POST /videos/import végpontjának (vagy az import_videos MCP-eszköznek):

curl --request POST "https://api.uplonic.com/videos/import"   --header "Content-Type: application/json"   --header "x-api-key: WORKSPACE_API_KEY"   --data '{
    "requireReview": true,
    "items": [
      {
        "url": "https://files2.heygen.ai/aws_pacific/avatar_tmp/abc123/video.mp4?Expires=1793000000&Signature=xyz&Key-Pair-Id=K123",
        "title": "Heti termékfrissítés — Digital Twin (9:16)",
        "description": "Három új ütemezési funkció 45 másodpercben.",
        "tags": ["heygen", "avatar", "product-update"],
        "idempotencyKey": "heygen-video-abc123xyz789"
      }
    ]
  }'

A linkkezelést ellenőriztük az Uplonic normalizeImportUrl moduljával:

• Azonnali letöltés, tiszta forrás-URL: Az Uplonic háttér-workere a teljes aláírt fetchUrl-ről tölti le a legfeljebb 500 MB-os MP4-et a link lejárata előtt, ellenőrzi a fájlfejlécet és a videósávot, majd a Video.sourceUrl mezőben már csak a query-tokenek nélküli tiszta útvonalat (https://files2.heygen.ai/aws_pacific/avatar_tmp/abc123/video.mp4) tárolja el.

• Webhook-duplikáció elleni védelem: Ha az idempotencyKey mezőbe a HeyGen video_id azonosítóját (8–200 karakter) írod, egy megismételt webhook-hívásnál az Uplonic nem tölti le újra a videót, hanem deduplicated: true jelzéssel visszaadja a meglévő importot.

• Ügyfél- vagy csapatjóváhagyás publikálás előtt: A requireReview: true opcióval a beérkező avatárvideó pending (jóváhagyásra váró) állapotba kerül, így ütemezés előtt ellenőrizhető a szájszinkron, a kiejtés és az AI-címke.

Más AI-videógenerátorokat is használsz? Olvasd el a Luma Dream Machine (Ray 2) klipek publikálásáról szóló cikkünket is.