OpenMontage 视频尺寸配置指南：HeyGen 720p/1080p 分辨率与多平台宽高比实战

OpenMontage 视频尺寸配置指南HeyGen 720p/1080p 分辨率与多平台宽高比实战【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage在 OpenMontage 开源 Agentic 视频制作系统中create-video技能.agents/skills/create-video/SKILL.md负责把一段文本提示词一键转化为完整视频而决定最终成片长什么样、适配哪个平台的第一道关卡就是视频尺寸dimension与宽高比aspect ratio。本指南以 HeyGen 生成接口为核心完整梳理 720p/1080p 标准分辨率、16:9 / 9:16 / 1:1 等主流画幅、自定义尺寸边界、平台适配清单、信用点成本权衡并落到 OpenMontage 工具层的aspect_ratio接口实现帮你从草稿到成片都能选对画幅、避免返工。一、这份尺寸参考在技能体系中的定位在 OpenMontage 的 Agent 技能目录里HeyGen 相关技能分属两条主线create-video基于文本提示词Video Agent 模式一次生成完整视频适合快速原型、产品演示、营销短视频技能要求先设置HEYGEN_API_KEY环境变量并优先走mcp__heygen__*MCP 工具。avatar-video逐场景精确控制虚拟人、台词、语音、背景与多场景编排标准/v2/video/generate接口。两条主线共享同一份尺寸事实——.agents/skills/create-video/references/dimensions.md在 avatar-video 技能下存在一份内容一致的姊妹文档。它解决的问题是告诉 Agent 各种分辨率/画幅对应的像素值、请求体如何携带dimension、平台默认画幅是什么、自定义尺寸有哪些硬性约束。二、标准分辨率速查Landscape / Portrait / SquareHeyGen 支持多种分辨率与宽高比以适配不同平台与场景核心是画幅 × 720p/1080p 两档清晰度。横屏 Landscape16:9分辨率宽度高度适用场景720p1280720标准画质处理更快1080p19201080高画质最常用竖屏 Portrait9:16分辨率宽度高度适用场景720p7201280移动端优先内容1080p10801920高清竖屏方形 Square1:1分辨率宽度高度适用场景720p720720社交媒体帖子1080p10801080高清方形记忆要点同一画幅下720p 是短边 7201080p 是短边 1080。横屏以高度为基准720/1080 在高竖屏以宽度为基准720/1080 在宽方形则宽高相等。三、在请求体中设置尺寸dimension字段标准生成接口POST /v2/video/generate的顶层字段之一就是dimension{width, height}它作用于整条视频包括其中的所有场景。TypeScript// Landscape 1080p const landscapeConfig { video_inputs: [...], dimension: { width: 1920, height: 1080 } }; // Portrait 1080p const portraitConfig { video_inputs: [...], dimension: { width: 1080, height: 1920 } }; // Square 1080p const squareConfig { video_inputs: [...], dimension: { width: 1080, height: 1080 } };curl# Landscape 1080p 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: [...], dimension: { width: 1920, height: 1080 } }需要说明的是dimension属于可选字段未指定时服务端会采用默认画幅。与之相邻的常用顶层字段还包括title视频名称、test测试模式带水印不计费、caption自动字幕开关、callback_url/callback_idWebhook 完成通知等详见 avatar-video 的视频生成参考。四、辅助函数把宽高比 清晰度换算成像素手工记 10 组像素值容易出错更可靠的做法是封装一张查表。文档给出了一套完整可用的 TypeScript 辅助函数覆盖五种主流宽高比type AspectRatio 16:9 | 9:16 | 1:1 | 4:3 | 4:5; type Quality 720p | 1080p; interface Dimensions { width: number; height: number; } function getDimensions(aspectRatio: AspectRatio, quality: Quality): Dimensions { const configs: RecordAspectRatio, RecordQuality, Dimensions { 16:9: { 720p: { width: 1280, height: 720 }, 1080p: { width: 1920, height: 1080 }, }, 9:16: { 720p: { width: 720, height: 1280 }, 1080p: { width: 1080, height: 1920 }, }, 1:1: { 720p: { width: 720, height: 720 }, 1080p: { width: 1080, height: 1080 }, }, 4:3: { 720p: { width: 960, height: 720 }, 1080p: { width: 1440, height: 1080 }, }, 4:5: { 720p: { width: 576, height: 720 }, 1080p: { width: 864, height: 1080 }, }, }; return configs[aspectRatio][quality]; } // Usage const youTubeDimensions getDimensions(16:9, 1080p); const tikTokDimensions getDimensions(9:16, 1080p); const instagramDimensions getDimensions(1:1, 1080p);注意getDimensions的 4:3 与 4:5 画幅是以高度 720/1080 为基准推导宽度的4:3 的 720p 是 960×7204:5 的 720p 则是 576×720。这样dimensions.md内的全部换算就汇总为下表宽高比720p宽×高1080p宽×高16:91280×7201920×10809:16720×12801080×19201:1720×7201080×10804:3960×7201440×10804:5576×720864×1080五、平台化推荐画幅按发布目标选尺寸同一个视频要投放到不同平台首帧观感与推荐画幅完全不同。文档给出如下现成配置YouTubeconst youtubeConfig { video_inputs: [...], dimension: { width: 1920, height: 1080 }, // 16:9 landscape };TikTok / Instagram Reels / YouTube Shortsconst shortFormConfig { video_inputs: [...], dimension: { width: 1080, height: 1920 }, // 9:16 portrait };Instagram Feed Postconst instagramFeedConfig { video_inputs: [...], dimension: { width: 1080, height: 1080 }, // 1:1 square };LinkedInconst linkedinConfig { video_inputs: [...], dimension: { width: 1920, height: 1080 }, // 16:9 landscape preferred };Twitter/Xconst twitterConfig { video_inputs: [...], dimension: { width: 1280, height: 720 }, // 16:9, 720p is common };一句话归纳横屏长视频走 16:9YouTube/LinkedIn 上 1080pX 上 720p 亦常见竖屏短视频走 9:16信息流帖子走 1:1 方形。六、Avatar IV照片级数字人的画幅通过orientation设置对 Avatar IV基于照片的虚拟人而言dimensions.md特别注明画幅不再直接给像素而是通过方向枚举设置type VideoOrientation portrait | landscape | square; function getAvatarIVDimensions(orientation: VideoOrientation): Dimensions { switch (orientation) { case portrait: return { width: 720, height: 1280 }; case landscape: return { width: 1280, height: 720 }; case square: return { width: 720, height: 720 }; } }这里orientation默认落在 720p 级别的像素几何1280×720 / 720×1280 / 720×720。值得注意的是这与仓库内另一条 HeyGen 链路——create-video技能对应的Video Agent 接口行为一致Video Agent 的config对象只暴露orientation: portrait | landscape外加可选duration_sec5–300 与avatar_id不允许直接传像素宽高详见 video-agent.md。换言之Video Agent / Avatar IV只声明方向landscape / portrait / square具体像素交给服务端标准/v2/video/generate直接声明dimension.width / height像素值精确控制。七、自定义尺寸合法边界与校验函数HeyGen 也允许在标准档位之外指定自定义尺寸但受三条硬性约束约束单边最小 128px单边最大 4096px宽高必须为偶数均可被 2 整除。自定义示例const customConfig { video_inputs: [...], dimension: { width: 1600, height: 900 // Custom 16:9 at non-standard resolution } };配套校验函数可直接在调用前做本地兜底避免无效请求打到计费接口function validateDimensions(width: number, height: number): boolean { if (width 128 || height 128) { throw new Error(Dimensions must be at least 128px); } if (width 4096 || height 4096) { throw new Error(Dimensions cannot exceed 4096px); } if (width % 2 ! 0 || height % 2 ! 0) { throw new Error(Dimensions must be even numbers); } return true; }提示偶数约束本质来自主流视频编码H.264/H.265 及各类 VAE/扩散管线对像素对齐的普遍要求。OpenMontage 仓库对本地模型甚至做了更细的对齐处理——例如 tools/video/_shared.py 中注明 Wan TI2V 系列的 720p 实际几何是1280×704而非 1280×720其 VAE 16 倍空间压缩叠加 transformer 2× patching要求双边是 32 的倍数。云端 HeyGen 的约束以官方 128/4096/偶数为准但理解几何对齐这一层能帮你排查画幅异常。八、清晰度 vs 信用点成本先 720p 打草稿再 1080p 出终稿更高分辨率会消耗更多积分。文档给出的相对成本对照如下分辨率相对成本720p基础费率1080p约为基础费率的 1.5×因此官方建议非常实用草稿与测试阶段用 720p最终成片再切 1080p。配套的省钱手段还可以参考同技能下的 quota.md生成前先查询GET /v2/user/remaining_quota用remaining_quota判断余额是否充足开发阶段尽可能开test: true测试模式输出带水印但不消耗积分积分不足时优先降为 720p 或裁剪时长而不是直接中断流程。九、背景素材尺寸必须与视频尺寸匹配画面中如果用到图片/视频背景dimensions.md强调背景素材的尺寸应尽量与目标视频尺寸一致否则可能出现裁切、留黑边或被迫缩放导致的画质损失// For 1080p landscape video const config { video_inputs: [ { character: {...}, voice: {...}, background: { type: image, url: https://example.com/1920x1080-background.jpg // Match video dimensions } } ], dimension: { width: 1920, height: 1080 } };在 avatar-video 的完整字段定义中背景还支持type: color配合 hex 色值value、video配合url以及fit: cover | contain控制适配方式参见 video-generation.md。此外字幕caption等元素也会随dimension排版选定画幅后建议一次性把背景、字幕一并定稿。十、工厂函数一份脚本适配所有平台把脚本 数字人 语音 目标平台抽象成一份配置工厂是规模化投放的标准做法。文档提供了可直接落地的完整实现interface VideoConfigOptions { script: string; avatarId: string; voiceId: string; platform: youtube | tiktok | instagram_feed | instagram_story | linkedin; quality?: 720p | 1080p; } function createVideoConfig(options: VideoConfigOptions) { const platformDimensions: Recordstring, Dimensions { youtube: { width: 1920, height: 1080 }, tiktok: { width: 1080, height: 1920 }, instagram_feed: { width: 1080, height: 1080 }, instagram_story: { width: 1080, height: 1920 }, linkedin: { width: 1920, height: 1080 }, }; const dimension platformDimensions[options.platform]; // Scale down for 720p if requested if (options.quality 720p) { dimension.width Math.round((dimension.width * 720) / 1080); dimension.height Math.round((dimension.height * 720) / 1080); } return { video_inputs: [ { character: { type: avatar, avatar_id: options.avatarId, avatar_style: normal, }, voice: { type: text, input_text: options.script, voice_id: options.voiceId, }, }, ], dimension, }; } // Usage const tiktokVideo createVideoConfig({ script: Hey everyone! Check this out!, avatarId: josh_lite3_20230714, voiceId: 1bd001e7e50f421d891986aad5158bc8, platform: tiktok, quality: 1080p, });avatarId/voiceId的具体取值来自 HeyGen 账号内的数字人avatars与语音voices资源可通过GET /v2/avatars列表获取尽量使用数字人自带的默认语音default_voice_id以获得最自然的匹配相关细节见 avatars.md 与 voices.md。十一、仓库实现侧OpenMontage 如何消费aspect_ratio理解了 HeyGen 的像素级dimension之后再回看 OpenMontage 的工具层会发现一条更抽象的接口仓库把 HeyGen 封装为heygen_video工具tools/video/heygen_video.py其input_schema中不再暴露裸像素而是暴露aspect_ratio字符串枚举aspect_ratio: { type: string, enum: [16:9, 9:16, 1:1], default: 16:9, },从源码看heygen_video.py 同时声明了agent_skills [ai-video-gen, create-video]即本节技能与工具互相打通底层调用 tools/video/_shared.py 的generate_heygen_video(inputs)把aspect_ratio原样透传进 HeyGen 的 workflow 请求体。同样的aspect_ratio: [16:9, 9:16, 1:1]默认 16:9枚举也出现在统一的视频选择路由 tools/video/video_selector.py 中并保留resolution作为命名分辨率提示透传给支持的供应商。OpenMontage 的 HeyGen 供应商矩阵tools/video/_shared.py把 VEO 3.1 / Kling / Sora 2 / Runway Gen-4 / Seedance / LTX 等模型映射为 provider 变体并各自标注quality与speed用于成本与耗时预估estimate_quality_cost/estimate_speed_runtime。可以推断在这一抽象层上选哪一家生成由provider_variant决定画面朝哪个方向由aspect_ratio决定细节像素则由供应商云端按画幅与档位自行解析——正好对应本文第一节画幅选型与第三节像素注入的分工。与此相关的转发/建包逻辑亦被契约测试覆盖例如 tests/contracts/test_atlas_tools.py 中对aspect_ratio、resolution、宽高换算的断言。十二、端到端最佳实践清单把文档建议与仓库实现合并成一份可直接照做的清单先定画幅再写配置横屏16:9服务 YouTube/LinkedIn 长内容竖屏9:16服务 TikTok/Reels/Shorts方形1:1服务信息流帖子不确定时用 第五节 的平台对照表。用辅助函数替代手写像素把getDimensions/createVideoConfig放进公共模块杜绝把 1080×1920 写反的低级错误。草稿走 720p终稿走 1080p1080p 大约多消耗 1.5× 积分开发迭代期优先test: true。请求前先校验在本地先跑一遍validateDimensions≥128、≤4096、偶数避免无效请求浪费往返与积分。背景素材对齐画幅图片/视频背景的分辨率尽量与dimension一致必要时用cover语义裁切而不是拉伸变形。Avatar IV / Video Agent 用方向、标准 API 用像素前两者传orientationportrait/landscape/square后者传dimension.width/height不要混用。在 OpenMontage 工具链路中直接用画幅枚举调用heygen_video时传aspect_ratio: 16:9 | 9:16 | 1:1让供应商矩阵自动完成其余配置。关联文件导航本指南主题来源.agents/skills/create-video/references/dimensions.md及内容一致的 .agents/skills/avatar-video/references/dimensions.md技能入口.agents/skills/create-video/SKILL.md / .agents/skills/avatar-video/references/video-generation.md配套参考video-agent.md、video-status.md、quota.md、assets.md工具实现tools/video/heygen_video.py、tools/video/_shared.py、tools/video/video_selector.py契约测试tests/contracts/test_atlas_tools.py【免费下载链接】OpenMontageWorlds first open-source, agentic video production system. 12 production pipelines, 100 tools, 700 agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考