菜单
Upload images, videos, audio, or PDFs to HeyGen and return reusable asset IDs. Use when the user wants to upload local files for HeyGen, prepare assets for Video Agent, avatars, image-to-video, video translation, or any HeyGen endpoint that accepts asset_id file inputs.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | heygen-asset-upload |
| description | Upload images, videos, audio, or PDFs to HeyGen and return reusable asset IDs. Use when the user wants to upload local files for HeyGen, prepare assets for Video Agent, avatars, image-to-video, video translation, or any HeyGen endpoint that accepts asset_id file inputs. |
POST /v3/assets uploads..env from the repo root before running scripts. Require HEYGEN_API_KEY; never print the key.asset_id values for later HeyGen calls.png/jpeg; video mp4/webm; audio mp3/wav; PDFs supported.POST https://api.heygen.com/v3/assets
Header: X-Api-Key: <HEYGEN_API_KEY>
Body: multipart/form-data file=@<path>
Successful responses include:
{
"data": {
"asset_id": "asset_abc123def456",
"url": "https://files.heygen.ai/assets/asset_abc123def456.png",
"mime_type": "image/png",
"size_bytes": 245760
}
}
Upload one or more files:
python skills/heygen-asset-upload/scripts/heygen_asset_upload.py upload \
--env-file .env \
--files jobs/<job_id>/input/raw_assets/images/person.jpg,jobs/<job_id>/input/raw_assets/audio/narration.mp3 \
--output jobs/<job_id>/source/heygen_assets.json
Print only the compact JSON response:
python skills/heygen-asset-upload/scripts/heygen_asset_upload.py upload \
--env-file .env \
--files path/to/file.png
When --output is provided, the script writes:
{
"assets": [
{
"path": "...",
"asset_id": "asset_...",
"url": "https://...",
"mime_type": "image/png",
"size_bytes": 12345,
"response": {}
}
]
}
Use uploaded assets in HeyGen file inputs as:
{ "type": "asset_id", "asset_id": "asset_..." }
Missing HEYGEN_API_KEY: add it to .env or export it in the shell.File too large: HeyGen limits uploads to 32 MB; compress or provide a public HTTPS URL instead.Unsupported file type: convert to a supported format before upload.401: invalid or inactive HeyGen API key.400 / 422: inspect the saved response; confirm the file field is named exactly file.Download public Facebook Reel videos with yt-dlp into the repository raw asset pool or a specific video job. Use when a user provides a facebook.com/reel, facebook.com/watch, Facebook video, or fb.watch URL and asks to download, save, or ingest the video as a local asset.
Search LyricFind for song lyrics and lyric context, especially to correct Vietnamese music STT before writing subtitle captions; use the bundled Python client instead of generic web search when a song title or artist is known.
Default low-cost lipsync workflow using WaveSpeedAI InfiniteTalk. Use when the user asks for lipsync, lip sync, talking photo/avatar, digital human from one image plus audio, cheap avatar video generation, or asks to animate a person speaking from an image and audio unless they explicitly choose another provider.
Create AI videos with KIE.AI Google Veo 3.1. Use when the user wants text-to-video, image-to-video with first/last frames, reference/material-to-video, extending Veo 3.1 tasks, polling status, or upgrading/downloading 1080p/4K results through the KIE Veo3 API.
Convert a finished video job into a reusable project template and Codex skill. Use when the user asks to turn a Remotion job into a template, standardize a copied job, create a reusable video template skill, parameterize a job, or make future video requests token-light while preserving visual quality and render reliability.
Prepare effect/overlay videos so they can be composited over another video, especially stock overlays with black backgrounds, dust, light particles, petals, smoke, flares, or non-alpha MP4/MOV assets. Use when Codex needs to check whether overlay videos have real alpha, convert ordinary overlay footage into Remotion-ready assets, normalize fps/size, preserve color for screen blending, avoid black halos from bad alpha keying, or generate reusable overlay files and compositing snippets.