video-agent

# 视频智能体 (Video Agent) API 视频智能体 API 可通过单个文本提示词生成完整的视频。与需要详细场景配置的标准视频生成 API 不同，视频智能体自动处理脚本编写、数字人选择、视觉效果、配音、节奏和字幕。 ## 何时使用视频智能体 vs 标准 API | 使用场景 | 推荐 API | |----------|-----------------| | 从创意快速生成视频 | 视频智能体 | | 对场景、数字人、时间轴的精确控制 | 标准 v2/video/generate | | 大规模自动化内容生成 | 视频智能体 | | 指定数字人及确切脚本 | 标准 v2/video/generate | | 原型或草稿视频 | 视频智能体 | | 品牌一致的生产级视频 | 标准 v2/video/generate | ## 端点 POST https://api.heygen.com/v1/video_agent/generate ## 请求字段 | 字段 | 类型 | 必填 | 描述 | |-------|------|:---:|-------------| | `prompt` | string | ✓ | 描述您想要视频的文本提示词 | | `config` | object | | 配置选项（见下文） | | `files` | array | | 生成中引用的资源文件 | | `callback_id` | string | | 用于追踪的自定义 ID | | `callback_url` | string | | 完成通知的 Webhook URL | ### 配置对象 | 字段 | 类型 | 描述 | |-------|------|-------------| | `duration_sec` | integer | 大致时长（秒，5-300） | | `avatar_id` | string | 指定使用的数字人（可选 - 若未提供则由智能体选择） | | `orientation` | string | `"portrait"` 或 `"landscape"` | ### 文件数组 | 字段 | 类型 | 描述 | |-------|------|-------------| | `asset_id` | string | 引用的已上传文件的资源 ID | ## 响应格式 { "error": null, "data": { "video_id": "abc123" } } ## curl 示例 bash curl -X POST "https://api.heygen.com/v1/video_agent/generate" -H "X-Api-Key: $HEYGEN_API_KEY" -H "Content-Type: application/json" -d '{ "prompt": "Create a 60-second product demo video for a new AI-powered calendar app. The tone should be professional but friendly, targeting busy professionals. Highlight the smart scheduling feature and time zone handling." }' ## TypeScript typescript interface VideoAgentConfig { duration_sec?: number; // 5-300 秒 avatar_id?: string; // 可选：指定数字人 orientation?: "portrait" | "landscape"; } interface VideoAgentFile { asset_id: string; } interface VideoAgentRequest { prompt: st