Docs · Content

How to connect your HeyGen avatar to the Craft content factory

Paste your HeyGen API key, pick your avatar, and Craft makes videos with it — script, editing, subtitles and posting. HeyGen renders the talking head.

Updated: November 21, 2026

If you already have a digital twin in HeyGen, you can connect it to the Craft content factory. Paste your HeyGen API key, pick the avatar, and Craft takes it from there: it writes the script, edits the video, adds subtitles, cutaways and your offer, and posts to your social accounts. HeyGen renders the talking head from the script.

Your Craft avatar isn't going anywhere. One factory can hold both Craft avatars and HeyGen avatars, and you choose who appears in each video.

What you need#

  • A HeyGen account with your own avatar: a twin made from video or a photo avatar.
  • A HeyGen API key and a topped-up API wallet in HeyGen.

⚠️ The HeyGen API wallet is separate from your subscription on the HeyGen website. Videos made through an API key are paid only from the API wallet. If you've only paid for the subscription, HeyGen will refuse the job — Craft will show you why and refund its own credits.

How to connect#

  1. In HeyGen, open Settings → API and create a key.
  2. In Craft, open "Content factory" → "My avatar" → "New avatar" → the "From HeyGen" tab. You can also just type "I want an avatar from HeyGen" in the Craft chat — a button to open this window will appear in the reply.
  3. Paste the key and click "Connect". Craft checks the key with HeyGen and shows your API wallet balance. The key is stored encrypted and never shows up in the chat.
  4. Pick an avatar from the list and a HeyGen model, then click "Add avatar". The avatar is ready right away: no test video, no training.

No HeyGen of your own — via Craft#

If you don't have a HeyGen account, you can create a twin right in Craft: it lives in Craft's HeyGen account, and you pay in Craft credits. You don't need a HeyGen API key or wallet.

  1. "Content factory" → "My avatar" → "New avatar" → the "From HeyGen" tab → "No HeyGen of my own — via Craft".
  2. Choose a video of you talking to the camera. The video of a Craft avatar you've already uploaded works; if there isn't one, first upload a video on the "Real person" tab. Craft takes up to three minutes from it.
  3. Choose a HeyGen model, confirm that it's you on camera or that you have that person's written consent, and click "Create twin".
  4. Give consent. HeyGen asks the person on camera to read a short phrase aloud — that's how it knows the twin is made with their permission. The "Give consent" button appears in the avatar window. The link works for 24 hours; if you miss it, click "New link".
  5. After consent, HeyGen trains the twin, usually in a few minutes. Once the avatar is ready, you can pick it for videos.

What it costs via Craft. The twin is a one-time charge at the price of training a Craft avatar. A video is a minute of editing, like "Editing only", plus a minute of the HeyGen face for the chosen model. You see both prices before you click the button and before you approve the text. If the twin doesn't work out or HeyGen fails to render a video, the credits come back automatically.

How much it costs with your own key#

  • In Craft, a video with a HeyGen avatar costs the same as "Editing only": the script, editing and posting are ours. You see the price before you approve the text.
  • In HeyGen, the talking head is charged at your API wallet rates. HeyGen lists its prices in its API dashboard, and they depend on the model.

HeyGen models#

You can choose a HeyGen model for each avatar: Avatar III, Avatar IV, Avatar V or Avatar 6. The default is Avatar IV. Pricier models look more lifelike, but they also cost more in HeyGen. Each avatar supports its own set of models — Craft shows only the ones that avatar supports.

What's not available yet#

  • Fixing a single phrase in a finished video with a HeyGen avatar isn't available: the voice is baked into the HeyGen video. Re-editing works; for new text, make the video again.
  • "Voice-over only" can't be made with a HeyGen avatar — choose a Craft avatar or a voice for it.

Frequently asked questions#

Can I make videos both with HeyGen and without it?#

Yes. Craft avatars and HeyGen avatars live in the same "My avatars" list, and for each video you choose who's on screen.

Does auto-posting work with a HeyGen avatar?#

Yes. Brand auto-posting uses any ready avatar of that brand, including a HeyGen avatar.

What happens if my HeyGen wallet runs out of money?#

The video won't be made. Craft will show the reason — "Your HeyGen API wallet doesn't have enough money" — and refund its credits for that video. Top up your API wallet in HeyGen and make the video again.

Where is my HeyGen key stored?#

In Craft, encrypted. Only the last few characters of the key are shown on screen, and the key never reaches the chat or the AI connector. You can change or disconnect the key on the same "From HeyGen" tab.

Do I need my own HeyGen account?#

No. Without one, choose "No HeyGen of my own — via Craft": the twin lives in Craft's account, and videos are paid in Craft credits. You only need your own HeyGen key if you want to pay HeyGen directly from your own API wallet.

Didn't find an answer?Message us on Telegram or email support@craftopen.space — we'll reply and extend the article.
Message on Telegram