Skip to main content

​
HeyGen

ShanoneのHeyGen連携では、HeyGenの動画生成プラットフォームのほぼ全機能——アバター、音声、リップシンク、動画翻訳、テンプレート、バッチ/一括操作、Webhookを扱う69のツールをエージェントが利用できるようになります。

​
はじめに

1

HeyGen APIキーを取得する

HeyGenアカウントのSettings → APIからキーを生成します。
2

Shanoneに登録する

ShanoneダッシュボードのIntegrationsを開き、HeyGenを選択してAPIキーを貼り付けます。
3

リクエストを再試行する

保存が完了すると、heygen_*ツールへのshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはHeyGen用に69のツールを提供しており、以下のカテゴリに分類されています。
heygen_create_avatar, heygen_create_avatar_consent, heygen_list_avatar_groups, heygen_get_avatar_group, heygen_list_avatar_looks, heygen_get_avatar_look, heygen_update_avatar_look
heygen_create_video, heygen_get_video, heygen_list_videos, heygen_delete_video, heygen_create_video_agent_session, heygen_get_video_agent_session, heygen_list_video_agent_sessions, heygen_list_session_videos, heygen_list_video_agent_styles, heygen_send_video_agent_message, heygen_stop_video_agent_session
heygen_list_voices, heygen_get_voice, heygen_clone_voice, heygen_design_voice, heygen_generate_speech
heygen_create_lipsync, heygen_get_lipsync, heygen_list_lipsyncs, heygen_update_lipsync, heygen_delete_lipsync
heygen_list_supported_languages, heygen_list_video_translations, heygen_get_video_translation, heygen_update_video_translation, heygen_delete_video_translation, heygen_create_video_translation
heygen_list_templates, heygen_get_template, heygen_generate_video_from_template, heygen_create_proofread_session, heygen_get_proofread_session, heygen_download_proofread_srt, heygen_upload_proofread_srt, heygen_generate_video_from_proofread
heygen_upload_asset, heygen_create_asset_upload, heygen_create_asset_upload_batch, heygen_create_video_batch, heygen_get_video_batch, heygen_create_video_translation_batch, heygen_create_lipsync_batch, heygen_bulk_video_statuses, heygen_list_brand_kits, heygen_list_brand_glossaries, heygen_get_brand_glossary
heygen_create_webhook_endpoint, heygen_list_webhook_endpoints, heygen_update_webhook_endpoint, heygen_delete_webhook_endpoint, heygen_rotate_webhook_signing_secret, heygen_list_webhook_event_types, heygen_list_webhook_events, heygen_create_ai_clipping, heygen_get_ai_clipping, heygen_list_ai_clippings, heygen_delete_ai_clipping, heygen_create_filler_word_removal, heygen_get_filler_word_removal, heygen_create_hyperframes_render, heygen_get_hyperframes_render, heygen_get_current_user

​
よくある使い方

テンプレートからの動画生成

HeyGenテンプレートの変数を入力し、パーソナライズされた動画を大量に生成する

多言語動画

既存の動画をリップシンク付き吹き替えで別の言語に翻訳する

カスタムアバターの作成

アップロードした映像/同意情報からトーキングフォトやフルアバターを作成する

一括生産

複数の台本にまたがる動画バッチを開始し、完了をポーリングする

​
トラブルシューティング

HeyGenのレンダリングは非同期です——キューに入った時点で完成したと見なさず、statusがcompletedまたはfailedを報告するまでheygen_get_video(バッチの場合はheygen_bulk_video_statuses)をポーリングしてください。
音声クローンやフォトアバターの作成には、元のアセットを使用する前にheygen_create_avatar_consentによる明示的な同意記録が必要です——これはHeyGen側の法的/コンプライアンス要件であり、Shanoneの制約ではありません。
heygen_create_webhook_endpointで登録したエンドポイントURLがHTTPSで公開アクセス可能であることを確認し、heygen_list_webhook_event_typesでそのアクションに対応する正しいイベントタイプを購読しているか確認してください。