360 Secure SkillHub
360 安全技能中心

Create Video

核心功能：输入文本提示，AI自动完成脚本撰写、 avatar选择、视觉、配音、字幕等全流程，生成完整视频。典型场景：制作讲解/演示/营销视频、快速生成视频原型草稿等。输入为文本提示（可指定时长、方向等），输出为视频下载链接。需配置HeyGen API密钥，支持MCP工具或直接API调用。

michaelwang11394
michaelwang11394
热度 59.99
最近更新 2026-05-11 17:31:34
分类：创作依赖：MCP 服务 / 第三方 API应用场景：视频编辑 / 营销 / 文案创作

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add create-video
Metadata
name
create-video
description
Create videos from a text prompt using HeyGen's Video Agent (POST /v3/video-agents). The default for most video requests — AI handles script, avatar, visuals, voiceover, and captions automatically. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) User says "make me a video" or "create a video about X". For precise control over specific avatars, exact scripts, or per-scene configuration, use the avatar-video skill instead.
homepage
https://docs.heygen.com/reference/create-video-with-video-agent
allowed-tools
mcp__heygen__*
metadata
{"openclaw":{"requires":{"env":["HEYGEN_API_KEY"]},"primaryEnv":"HEYGEN_API_KEY"}}

Create Video

Generate complete videos from a text prompt. Describe what you want and the AI handles script writing, avatar selection, visuals, voiceover, pacing, and captions automatically.

Authentication

All requests require the X-Api-Key header. Set the HEYGEN_API_KEY environment variable.

curl -X POST "https://api.heygen.com/v3/video-agents" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a 60-second product demo video."}'

Tool Selection

If HeyGen MCP tools are available (mcp__heygen__*), prefer them over direct HTTP API calls — they handle authentication and request formatting automatically.

Task MCP Tool Fallback (Direct API)
Generate video from prompt mcp__heygen__generate_video_agent POST /v3/video-agents
Check video status / get URL mcp__heygen__get_video GET /v3/videos/{video_id}
List account videos mcp__heygen__list_videos GET /v3/videos
Delete a video mcp__heygen__delete_video DELETE /v3/videos/{video_id}

If no HeyGen MCP tools are available, use direct HTTP API calls as documented in the reference files.

Default Workflow

Always use prompt-optimizer.md guidelines to structure prompts with scenes, timing, and visual styles.

With MCP tools:

  1. Write an optimized prompt using prompt-optimizer.md → visual-styles.md
  2. Call mcp__heygen__generate_video_agent with prompt and config (duration_sec, orientation, avatar_id)
  3. Call mcp__heygen__get_video with the returned video_id to poll status and get the download URL

Without MCP tools (direct API):

  1. Write an optimized prompt using prompt-optimizer.md → visual-styles.md
  2. POST /v3/video-agents — see video-agent.md
  3. GET /v3/videos/<id> — see video-status.md

Reference Files

Read these as needed — they contain endpoint details, request/response schemas, and code examples (curl, TypeScript, Python).

Core workflow:

Foundation:

Best Practices

  1. Optimize your prompt — quality depends entirely on prompt structure. Always use the prompt optimizer
  2. Lock avatar if needed — pass avatar_id for consistency across videos
  3. Specify voice — pass voice_id for a specific narrator voice
  4. Upload reference files — help the agent understand your brand/product
  5. Iterate on prompts — refine based on results; Video Agent is great for quick iterations