video-generation

# 视频生成 `/v2/video/generate` 端点是使用 HeyGen 创建 AI 数字人视频的主要方式。 ## 视频输出格式 | 端点 | 格式 | 使用场景 | |----------|--------|----------| | `/v2/video/generate` | MP4 | **标准** - 带背景的视频（最常用） | | `/v1/video.webm` | WebM | 透明背景 - 仅在需要时使用 | 大多数情况下请使用带背景的 MP4。仅当你需要在数字人 *背后* 显示内容（例如将数字人叠加在屏幕录制上）时才需要 WebM。 ## 基础视频生成 ### curl bash curl -X POST "https://api.heygen.com/v2/video/generate" -H "X-Api-Key: $HEYGEN_API_KEY" -H "Content-Type: application/json" -d '{ "video_inputs": [ { "character": { "type": "avatar", "avatar_id": "josh_lite3_20230714", "avatar_style": "normal" }, "voice": { "type": "text", "input_text": "Hello! Welcome to HeyGen.", "voice_id": "1bd001e7e50f421d891986aad5158bc8" } } ], "dimension": { "width": 1920, "height": 1080 } }' ## 请求字段 ### 顶级字段 | 字段 | 类型 | 必填 | 描述 | |-------|------|:---:|-------------| | `video_inputs` | array | ✓ | 1-50 个视频输入对象的数组 | | `dimension` | object | | 视频尺寸 `{width, height}` | | `title` | string | | 用于组织的视频名称 | | `test` | boolean | | 测试模式（带水印，不消耗点数） | | `caption` | boolean | | 启用自动字幕 | | `callback_id` | string | | 用于 Webhook 追踪的自定义 ID | | `callback_url` | string | | 完成通知的 URL | | `folder_id` | string | | 存储文件夹 ID | ### video_inputs[].character 字段 | 字段 | 类型 | 必填 | 描述 | |-------|------|:---:|-------------| | `type` | string | ✓ | `"avatar"` 或 `"talking_photo"` | | `avatar_id` | string | ✓* | 数字人 ID（当类型为 "avatar" 时必填） | | `talking_photo_id` | string | ✓* | 照片 ID（当类型为 "talking_photo" 时必填） | | `avatar_style` | string | | `"normal"`, `"closeUp"` 或 `"circle"` | | `scale` | number | | 数字人缩放比例 | | `offset` | object | | 位置偏移量 `{x, y}` | ### video_inputs[].voice 字段 | 字段 | 类型 | 必填 | 描述 | |-------|------|:---:|-------------| | `type` | string | ✓ | `"text"`, `"audio"` 或 `"silence"` | | `voice_id` | string | ✓* | 语音 ID（当类型为 "text" 时必填） | | `input_text` | string | ✓* | 脚本