heygen-best-practices

使用するタイミング

HeyGen API のコードを扱う際には、AI アバター動画の作成、アバターの管理、動画生成ワークフローの処理、HeyGen サービスとの連携に関するドメイン固有の知識を得るために、このスキルを使用してください。

使い方

詳しい説明とコード例については、個別のルールファイルを参照してください。

基礎

• rules/authentication.md - API キーの設定、X-Api-Key ヘッダー、認証パターン
• rules/quota.md - クレジットシステム、使用制限、残りのクォータの確認
• rules/video-status.md - ポーリングパターン、ステータスの種類、ダウンロード URL の取得
• rules/assets.md - 動画生成で使用する画像、動画、音声のアップロード

中核となる動画作成

• rules/avatars.md - アバターの一覧表示、アバタースタイル、avatar_id の選択
• rules/voices.md - 音声の一覧表示、ロケール、速度・ピッチの設定
• rules/scripts.md - スクリプトの作成、ポーズ・ブレイク、ペーシング、構成テンプレート
• rules/video-generation.md - POST /v2/video/generate のワークフローとマルチシーン動画
• rules/video-agent.md - Video Agent API によるワンショットのプロンプト動画生成
• rules/dimensions.md - 解像度のオプション（720p/1080p）とアスペクト比

動画のカスタマイズ

• rules/backgrounds.md - 単色、画像、動画の背景
• rules/text-overlays.md - フォントと配置を指定したテキストの追加
• rules/captions.md - 自動生成キャプションと字幕オプション

高度な機能

• rules/templates.md - テンプレートの一覧表示と変数の置換
• rules/video-translation.md - 動画の翻訳、品質・高速モード、吹き替え
• rules/streaming-avatars.md - リアルタイムのインタラクティブアバターセッション
• rules/photo-avatars.md - 写真からのアバター作成（トーキングフォト）
• rules/webhooks.md - Webhook エンドポイントの登録とイベントタイプ

連携

• rules/remotion-integration.md - Remotion コンポジションでの HeyGen アバター動画の利用