用途
ai-video-gen 用于通过文本提示词生成 AI 视频，底层调用 HeyGen API。适用于根据文字描述生成视频、为产品图或静态图片制作动态视频片段等场景。
主要能力
- 文本生成视频：提交 prompt 即可生成视频。
- 多提供商支持：VEO 3.1（默认，质量最高）、VEO 3.1 Fast、VEO 3、VEO 3 Fast、VEO 2、Kling Pro、Kling V2、Sora V2、Sora V2 Pro、Runway Gen-4、Seedance Lite、Seedance Pro、LTX Distilled（最快）。
- 画面比例配置：默认 16:9，常见值包括 16:9、9:16、1:1。
- 图生视频：可通过 reference_image_url 传入参考图片，通过 tail_image_url 指定尾帧引导。
- 提供商专属配置：可通过 input.config 覆盖提供商相关配置。
使用方式
认证：所有请求都需要 X-Api-Key 请求头，需设置 HEYGEN_API_KEY 环境变量。
默认工作流：
- 调用 POST /v1/workflows/executions，workflow_type 为 "GenerateVideoNode"，并传入 prompt。
- 响应中返回 execution_id。
- 每 10 秒轮询 GET /v1/workflows/executions/{id}，直到状态为 completed。
- 使用输出中返回的 video_url。
执行视频生成：
- 端点：POST https://api.heygen.com/v1/workflows/executions
- 请求字段：workflow_type（必填，必须为 "GenerateVideoNode"）、input.prompt（必填）、input.provider（可选，默认 "veo_3_1"）、input.aspect_ratio（可选，默认 "16:9"）、input.reference_image_url（可选）、input.tail_image_url（可选）、input.config（可选）。
响应格式示例： { "data": { "execution_id": "node-gw-v1d2e3o4", "status": "submitted" } }
查询状态：
- 端点：GET https://api.heygen.com/v1/workflows/executions/{execution_id}
- 完成时响应包含 output.video.video_url、output.video.video_id 以及 output.asset_id。
轮询完成：可编写函数在提交后按固定间隔轮询，直到状态为 completed、failed 或 not_found；示例中最大等待 600000 毫秒，轮询间隔 10000 毫秒。
适用场景
- 简单文本生成视频。
- 图生视频：为产品照片或静态图片添加缓慢缩放、柔和粒子等动效。
- 社交媒体竖版视频：使用 9:16 比例。
- 快速生成：使用 LTX Distilled 等快速提供商。
限制与注意事项
- 视频生成是最慢的工作流，建议预留最多 5 分钟，每 10 秒轮询一次。
- 输出 URL 是临时的，应及时下载或保存生成的视频。
- 输出包含 asset_id，可用于在其他 HeyGen 工作流中引用该视频。
- 提示词应尽量描述性，包含镜头运动、光照、风格和氛围细节。
- 追求最高质量时默认使用 VEO 3.1；追求速度时使用 ltx_distilled 或 veo3_fast。
- 画面比例需按用途选择：9:16 用于社交媒体故事/短视频，16:9 用于横屏，1:1 用于方形。
- 关于收费、价格、平台支持范围等事实，资料中暂未提供。