[ PROMPT_NODE_24850 ]
avatars
[ SKILL_DOCUMENTATION ]
# HeyGen 数字人
数字人是 HeyGen 视频中 AI 生成的演示者。你可以使用 HeyGen 提供的公共数字人,也可以创建自定义数字人。
## 生成前预览数字人
在生成视频之前,请务必预览数字人,以确保它们符合用户的偏好。每个数字人都有可以直接在浏览器中打开的预览 URL——无需下载。
### 快速预览:在浏览器中打开 URL(推荐)
预览数字人最快的方法是直接在默认浏览器中打开 URL。**不要先下载图像**——只需将 URL 传递给 `open` 命令:
bash
# macOS: 直接在默认浏览器中打开 URL(不下载)
open "https://files.heygen.ai/avatar/preview/josh.jpg"
# 打开预览视频以查看动画
open "https://files.heygen.ai/avatar/preview/josh.mp4"
# Linux: 使用 xdg-open
xdg-open "https://files.heygen.ai/avatar/preview/josh.jpg"
# Windows: 使用 start
start "https://files.heygen.ai/avatar/preview/josh.jpg"
macOS 上的 `open` 命令直接在默认浏览器中打开 URL,它不会下载文件。这是让用户查看数字人预览的最快方法。
### 列出数字人并打开预览
typescript
async function listAndPreviewAvatars(openInBrowser = true): Promise {
const response = await fetch("https://api.heygen.com/v2/avatars", {
headers: { "X-Api-Key": process.env.HEYGEN_API_KEY! },
});
const { data } = await response.json();
for (const avatar of data.avatars.slice(0, 5)) {
console.log(`n${avatar.avatar_name} (${avatar.gender})`);
console.log(` ID: ${avatar.avatar_id}`);
console.log(` Preview: ${avatar.preview_image_url}`);
}
// 直接在浏览器中打开预览 URL(无需下载)
if (openInBrowser) {
const { execSync } = require("child_process");
for (const avatar of data.avatars.slice(0, 3)) {
// macOS 上的 'open' 在默认浏览器中打开 URL - 不会下载
execSync(`open "${avatar.preview_image_url}"`);
}
}
}
**注意:** `open` 命令将 URL 传递给浏览器——它不会下载。浏览器直接获取并显示图像。
### 工作流:生成前预览
1. **列出可用数字人** - 获取名称、性别和预览 URL
2. **在浏览器中打开预览** - 使用 `open ` 进行快速视觉检查
3. **用户选择** 偏好的数字人名称或 ID
4. **获取数字人详情** 以获取 `default_voice_id`
5. **生成视频** 使用选定的数字人
bash
# 示例工作流