HeyGen の使い方とは、アバターを選び、話す文章と声を決めて、AI に話す動画を作らせるまでの手順です。

  • アバターの作り方の違い（写真から作る・本人の動画から作る Digital Twin）と、画面で 1 本作る基本の流れ
  • AI の席に回させる時の口（API の鍵・MCP）と、v1・v2 の API が 2026-10-31 で終わる件
  • 当社が縦の短い動画を回し始める前に、口・口座・ログインで詰まった所と、どう直したか

先に決める事: どのアバターで話させるか

HeyGen の動画は、アバター（話す人の姿）と、話す文章と、声でできています。最初に決めるのは、どのアバターに話させるかです。公式のヘルプでは、公開のアバターから選ぶか、自分のアバターを作るかを選べます（Overview our New AI Studio・2026-10-27 に見た）。

アバターの作り方元にする物作る時の要点
公開のアバターHeyGen が用意した姿選ぶだけ。自分の姿ではない
Photo Avatar写真 1 枚（または AI で作った絵）アバターの頁で New Avatar → 写真を上げて名前を付けて出す。使えるまでに確かめの段がある
Digital Twin（動画のアバター）本人を撮った動画New Avatar → Clone a Real Person。1080p・30fps 以上、切れ目の無い 1 本で、最低 2 分・勧めは 5 分まで。最後に本人の同意の動画を撮る

出典: How to Get Started with Photo Avatars・Create your first Digital Twin (Video Avatar) with Avatar IV・Overview our New AI Studio（どれも 2026-10-27 に見た）。

1 人のアバターには、服や背景や構図の違う「ルック（Look）」を持たせられます。写真から作るルックと、動画から作るルックがあり、見た目はルックが、動きと声はアバターの別の所が受け持つ、と公式は説明しています（Avatar Looks Explained・2026-10-27 に見た）。

画面で 1 本作る基本の流れ

公式のヘルプにある AI Studio の流れは、次の順です（Overview our New AI Studio・2026-10-27 に見た）。

  1. 左のメニューの Create から Create a Video を選び、横長（Landscape）か縦長（Portrait）かを決める
  2. Create in AI Studio を選ぶ
  3. アバターを選ぶ（公開のアバターか、自分のアバター）
  4. アバターに話させる文章を入れる。同じ所で、声の訛り・調子・モデル・速さなどを決める
  5. 右のメニューから、素材・文字・音楽・字幕・テンプレートを足す

書き出しの細かい手順は、この頁には書かれていませんでした。縦の短い動画を作るなら、1 の段で縦長を選んでおきます。

AI の席に回させる口: API の鍵と MCP

画面で作る代わりに、AIエージェント の席に動画を作らせる時は、HeyGen の API か MCP を使います。

  • API: HeyGen の画面の API の鍵の頁で鍵を作り、要求の X-Api-Key の欄に入れて送ります。鍵が生きているかは GET /v3/users/me で確かめられます（API Key・2026-10-27 に見た）
  • MCP: HeyGen は遠くに置かれた MCP サーバー（https://mcp.heygen.com/mcp/v1/）を出しており、AI の道具の接続の設定にこの住所を足して、HeyGen にログインして繋ぎます。公式は「API の鍵も、入れる物も要らない」と書いています。アバターの動画を作る・アバターやルックを扱う・声を作る、などの道具が並びます（HeyGen MCP Overview・2026-10-27 に見た）

heygen mcp で探すと、この公式の遠い MCP と、機体に置いて動かす形の MCP の両方が見つかります。当社の席が使っていたのは、機体に本体を置いて起動する形の口でした。こちらは、機体に本体が無いと起動の時点で落ちます（下の「詰まった所」）。MCP の口が起動しない時の足し方は Claude Code の MCP の頁にまとめています。

v1・v2 の API は 2026-10-31 で終わる

HeyGen の公式の文書は、v1 と v2 の口を 2026-10-31 で終える、と知らせています。2026-11-01 から v1・v2 は退かれ、それまでに v3 へ移すように、とあります。v2 の応答には「この v2 の口は Legacy で、2026-10-31 に消える。POST /v3/videos へ移るように」という文が入る、とも書かれています（Endpoint Version Comparison・2026-10-27 に見た）。変更の記録にも、v1・v2 は 2026-10-31 に終わる、複数の場面の Studio API と Template API は v3 の同じ物が出るまで v2 で続ける、とあります（Changelog・2026-10-27 に見た）。

当社も、HeyGen の画面に「v2 の口は 2026-10-31 で終わる」という警告が出ているのを見ています（社の実測 2026-10-25）。API で動画を作らせる口を前に作った所は、どの版を呼んでいるかを先に確かめます。

当社が回し始める前に詰まった所

当社は、縦の短い動画を AI の席に回させる前に、席の機体で HeyGen の口が本当に動くかを確かめました。詰まった所と直し方を、起きた順に並べます。

詰まった所分かった原因どうしたか
HeyGen の MCP の口が起動で落ちた（MODULE_NOT_FOUND）その機体の MCP の置き場に、口の本体が入っていなかった本体を入れ直して起動した
画面に v2 の口が終わる警告v1・v2 が 2026-10-31 で終わる口を HeyGen の v3 の API へ移した
鍵のメモの口座に、アバターが無かったメモの口座と、実際にアバターと残高を持つ口座が別だったメモを正しい口座に直した
見えない窓（ヘッドレスのブラウザ）でログインできないCloudflare に弾かれたいつもの Chrome で、メールのリンクから入った

出典: 社の実測 2026-10-25（席の機体での MCP の口の起動・API の直接の読み・画面での口座の確かめ）。

MCP の口は落ちたが、API は動いていた

最初に MCP の口を起動すると、MODULE_NOT_FOUND で落ちました。機体に本体が無い、という意味の誤りです。そこで鍵で HeyGen の API を直接読むと、登録済みのアバター（経営者本人の縦の姿など）は在り、API そのものは動いていました（社の実測 2026-10-25）。口が落ちた時に API を直に読むと、「HeyGen の側」と「機体の側」のどちらが悪いかを切り分けられます。原因はその機体の MCP の置き場に本体が入っていなかった事で、入れ直して起動しました。同じ時に、10/31 で終わる v1・v2 から v3 の API へ口を移しました（社の実測 2026-10-25）。

鍵のメモの口座と、アバターの在る口座が別だった

口座の状態を画面で読みに行くと、鍵のメモに書いてあった口座と、実際にアバターと残高を持っている口座が別でした。メモの方は、アバターが 1 つも無い別の口座でした（社の実測 2026-10-25）。メモを正しい口座に直しました。API の鍵は口座ごとに出るので、「鍵は通るのにアバターが無い」時は、まず口座が合っているかを疑います。

見えない窓では入れず、いつもの Chrome で入った

画面を AI の席に読ませるため、見えない窓（ヘッドレスのブラウザ）で HeyGen に入ろうとすると、Cloudflare に弾かれて入れませんでした。いつもの Chrome で、メールのリンクから入りました（社の実測 2026-10-25）。入った先で、本人の 4 つのルックと、短い動画から作った分身（Digital Twin）が在るのを確かめました（社の実測 2026-10-25）。

当社の縦の短い動画は 2 種類で回す

当社は、縦の短い動画を 2 種類の作り方で回します（社の実測 2026-10-25）。HeyGen を使うのは、そのうちゼロから作る方です。

  • 素材の在る物（勉強会・合宿の録画）: 録画から切り抜く。HeyGen は使わない
  • ゼロから文章で作る物: 声（MiniMax の本人の声）＋HeyGen のアバター＋スライドの組み合わせで作る

録画からの切り抜きと編集の流れは 動画編集 AI、録画の文字起こしは 動画文字起こし AI、動画に添える画像は バナー作成 AI の頁で扱っています。

よくある質問

HeyGen で自分のアバターを作るには何が要りますか？

写真から作る Photo Avatar なら写真 1 枚から作れます。本人の動きや話し方まで写す Digital Twin なら、1080p・30fps 以上で切れ目の無い動画を最低 2 分（勧めは 5 分まで）撮り、最後に本人の同意の動画を撮ります（HeyGen のヘルプ・2026-10-27 に見た）。

HeyGen の MCP はどう繋ぎますか？

公式の MCP は遠くに置かれたサーバーで、AI の道具の接続の設定に https://mcp.heygen.com/mcp/v1/ を足し、HeyGen にログインして繋ぎます。API の鍵は要らないと公式は書いています（HeyGen MCP Overview・2026-10-27 に見た）。機体に置く形の口を使う場合は、機体に本体が入っているかを先に確かめます（社の実測 2026-10-25）。

HeyGen の API の v2 はいつまで使えますか？

公式の文書では、v1・v2 は 2026-10-31 まで動き、2026-11-01 から退かれます（Endpoint Version Comparison・2026-10-27 に見た）。動画を作る口は POST /v3/videos へ移すよう案内されています。当社も口を v3 へ移しました（社の実測 2026-10-25）。

API の鍵は通るのに、自分のアバターが出てこないのはなぜですか？

鍵が、アバターを持つのとは別の口座の物である事があります。当社では、鍵のメモの口座がアバターの無い別の口座で、メモを直して解けました（社の実測 2026-10-25）。画面で口座を確かめ、その口座の鍵を使っているかを見ます。

出典

  1. HeyGen Help Center「Overview our New AI Studio!」 https://help.heygen.com/en/articles/11049655-overview-our-new-ai-studio（2026-10-27 に見た・画面で動画を作る基本の流れ・アバターの選び方）
  2. HeyGen Help Center「How to Get Started with Photo Avatars」 https://help.heygen.com/en/articles/10034438-how-to-get-started-with-photo-avatars（2026-10-27 に見た・写真から作るアバター）
  3. HeyGen Help Center「Create your first Digital Twin (Video Avatar) with Avatar IV!」 https://help.heygen.com/en/articles/12089286-create-your-first-digital-twin-video-avatar-with-avatar-iv（2026-10-27 に見た・Digital Twin の作り方・撮る動画の条件と長さ・同意の動画）
  4. HeyGen Help Center「Avatar Looks Explained」 https://help.heygen.com/en/articles/9964694-avatar-looks-explained（2026-10-27 に見た・ルックの説明）
  5. HeyGen Developers「API Key」 https://developers.heygen.com/docs/api-key（2026-10-27 に見た・鍵の作り方と送り方・GET /v3/users/me での確かめ）
  6. HeyGen Developers「MCP Overview」 https://developers.heygen.com/mcp/overview（2026-10-27 に見た・遠い MCP サーバーの住所・繋ぎ方・道具の並び）
  7. HeyGen Developers「Endpoint Version Comparison」 https://developers.heygen.com/endpoint-version-comparison（2026-10-27 に見た・v1／v2 の終わりの日付・v2 の応答の警告文）
  8. HeyGen Developers「Changelog」 https://developers.heygen.com/changelog（2026-10-27 に見た・v1／v2 の終わりの知らせ・Studio API と Template API の扱い）
  9. 社の実測 2026-10-25（席の機体で HeyGen の MCP の口の起動・API の直接の読み・画面の v2 の警告・口の本体の入れ直しと v3 への移し替え・画面での口座とアバターの確かめ・ヘッドレスのブラウザでのログイン）
  10. 社の実測 2026-10-25（縦の短い動画の 2 種類の作り方）