ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

HyperFrames 如何登录 HeyGen 账号并用 auth status 验证凭据配置

HyperFrames 如何登录 HeyGen 账号并用 auth status 验证凭据配置 HyperFrames 如何登录 HeyGen 账号并用 auth status 验证凭据配置【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframesHyperFrames 在本地创建和渲染视频不需要任何账号但当你想用 HeyGen 托管的语音与音乐、managed cloud rendering、hosted MCP或需要一个归属于你、之后还能更新的已发布项目时就需要先登录 HeyGen 账号。这篇文章给出用 CLI 登录的完整路径默认走浏览器 OAuth无头环境改用 API key最后用npx hyperframes auth status验证凭据来源、已验证身份并在脚本中判断登录状态。所有命令通过npx hyperframes执行。什么时候需要登录什么时候不需要先判断你是否真的需要这一步避免多做一次 OAuth不需要账号本地创建、渲染都能正常进行。没有凭据时语音可以回退到本地Kokoro引擎音乐可以回退到MusicGen见后文无凭据时的回退。需要登录的场景源文档明确列出使用 HeyGen 语音和音乐、managed cloud rendering、hosted MCP或拥有已发布项目的归属权之后可以用--update更新同一 URL。登录本身与注册是同一个 OAuth 流程——没有账号的新用户执行登录后会直接落到注册页不需要单独走一遍先注册再登录。主路径浏览器 OAuth 登录在有图形界面、能打开浏览器的机器上执行npx hyperframes auth login # ✓ Signed in.默认流程会打开浏览器完成 OAuth并在 loopback 端口捕获 token。上面的✓ Signed in.是文档给出的成功输出示例。登录成功后凭据写入~/.heygen/credentials文件权限为0600。这份凭据与独立的heygenCLI 共享——用其中任一工具登录另一边直接沿用同一会话每个仓库也不需要单独维护.env。可选分支CI 或无头机器改用 API key没有浏览器时保存一个长期有效的 HeyGen API key# 隐藏输入提示 npx hyperframes auth login --api-key # 从 stdin 读取适合 CI echo $HEYGEN_API_KEY | npx hyperframes auth login --api-key--api-key用于存储长期 key 而不是走浏览器流程$HEYGEN_API_KEY是你自己在环境中已设置的变量命令从 stdin 原样读入。该 key 会先经过GET /v3/users/me校验命令才会报告成功被 API 拒绝的 key 不会留在磁盘上。用 auth status 验证凭据配置登录完成后执行npx hyperframes auth status文档说明它显示的内容当前生效凭据的来源与类型以及已验证身份账号加账单快照当你处于未登录状态时会显示语音和音乐将使用哪些本地引擎。它还有两个对自动化很重要的行为未配置任何凭据、或 API 拒绝该凭据时命令以非零退出码结束脚本可以直接用它测试登录状态加--json时在脚本中拿到结构化输出npx hyperframes auth status --json # { configured, recommended_action, offline_engines }看懂 status 报告的来源凭据解析顺序auth status报告哪个凭据生效依据的是 first-match-wins 解析顺序HEYGEN_API_KEY—— 环境变量最高优先级HYPERFRAMES_API_KEY—— 前者的别名用于与其他工具保持一致~/.heygen/credentials—— 由hyperframes auth login或heygen auth login写入。如果你需要指向别的配置目录或后端变量用途默认值HEYGEN_CONFIG_DIR凭据目录~/.heygenHEYGEN_API_URLAPI 基础 URLhttps://api.heygen.com也就是说即使本地存有 OAuth 凭据只要设置了HEYGEN_API_KEY环境变量它就优先于文件中的凭据生效——排错为什么 status 显示的不是我刚登录的账号时先检查这个变量。边界与限制无凭据是本地工作的正常状态安装好依赖和模型文件后语音用 Kokoro-82M54 种声音配 Whisper 做词级字幕对齐、音乐用 MusicGenfacebook/musicgen-small、音效用内置库。本地引擎在设置完成后不调用托管生成 API但首次使用可能下载模型文件。工作流如何用它内置媒体工作流在生成前会运行hyperframes auth status并告诉你实际将走哪条 provider 路径语音HeyGen → ElevenLabs → Kokoro音乐HeyGen 曲库 → Lyria → MusicGen。登录的隐私影响执行hyperframes auth login后你的 HeyGen 账号邮箱账号没有邮箱时为用户名会与你的使用记录关联此前的匿名使用记录会被合并进来。凭据维护hyperframes auth refresh强制刷新存储的 OAuth access token只对 OAuth 会话有效对 API key 不适用hyperframes auth logout删除已存凭据TTY 上会有确认提示--keep-api-key只清 OAuth 会话--yes跳过提示。下一步登录完成后云渲染复用auth status解析到的同一份凭据一次性完成打包、上传、轮询、下载hyperframes cloud render ./my-video更多子命令cloud list、--no-wait等和完整选项参见 CLI 参考 和 Authentication API keys 指南。【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表