Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs(release): externalize showcase media and refresh the quickstart
kashorinf3f0b6f8ad41
diff --git a/README.md b/README.mdindex 6d81f8fb..a9f925e1 100644--- a/README.md+++ b/README.md@@ -43,7 +43,7 @@ Hypit gives AI agents (Claude Code, Codex...) a language and system to create vi**To be clear:** cloning a video is the fastest way in, not the only one. You can start from our templates, or just describe the video you want and your agent writes the workflow from scratch. Generation models are optional too: a workflow can compile captions, motion graphics and code-rendered visuals into a finished video without calling a single model, so a video can cost exactly $0.-+<p align="center"><em>SVML source on the left, with the corresponding video rendered live on the right.</em></p>@@ -53,8 +53,8 @@ Hypit gives AI agents (Claude Code, Codex...) a language and system to create vinpx skills add hypit-ai/hypit -g```-OpenAgents and other Skill hubs install the same canonical `skills/hypit/` directory. On first use,-the Skill prepares the executable Hypit Distribution separately; your video project can live anywhere.+This installs the Skill. On first use, your agent checks for the Hypit executable and helps prepare+it if needed. Your video project can live anywhere.## Examples@@ -66,14 +66,14 @@ the Skill prepares the executable Hypit Distribution separately; your video proj<tr><th width="16%">Reference</th><td width="28%"></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/f573bdac-62da-4b5d-825d-54d5880a7026" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-reference.mp4" controls muted></video></td><td width="28%"></td></tr><tr><th width="16%">Clones</th>- <td width="28%"><video src="https://github.com/user-attachments/assets/3ffd9951-e423-4a48-ad8f-5c596627be69" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/eb62372d-2464-4a4b-83ee-41e227f99a8e" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/9ba050f6-355d-460c-b684-7344cf49c051" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-clone-1.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-clone-2.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-clone-3.mp4" controls muted></video></td></tr><tr><td colspan="4"><p><b>"GOAT DEBATE"</b> — a 20-second football tier list that puts Ronaldo in D and Messi in S. Two Seedance 2 Mini 720p trolling A-rolls, a 2K goth girl portrait and ten 1K brain-rot B-rolls by GPT Image 2, WhisperX word alignment, a sound-synced ranking board, color-box karaoke captions, buttery-smooth animation and catchy background music, concurrently rendered in 64 headless Chromium processes.</p><p>Three clones included: swap the narrator to banana cat, flip the rankings and Ronaldo becomes GOAT, or replace all players with tech founders — same viral structure, different viral video.</p><p>Total cost: <b>$1.15</b>.</p></td>@@ -88,14 +88,14 @@ the Skill prepares the executable Hypit Distribution separately; your video proj<tr><th width="16%">Reference</th><td width="28%"></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/22df72b8-4831-4eb6-957d-676ae9b04f2d" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-reference.mp4" controls muted></video></td><td width="28%"></td></tr><tr><th width="16%">Clones</th>- <td width="28%"><video src="https://github.com/user-attachments/assets/9c14c5ae-bd12-4961-9d57-a46d3a2154c6" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/f44c653b-f520-4715-9530-4c2f42114387" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/92f9bf8b-4f83-4d9b-a0e8-ca27fab2cc94" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-clone-1.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-clone-2.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-clone-3.mp4" controls muted></video></td></tr><tr><td colspan="4"><p><b>"DAILY CREATINE"</b> — an 18-second podcast clip where a muscle barbie forces creatine on a skinny college kid. Three confrontational A-rolls and an aspirational lifestyle B-roll by Seedance 2 Mini 720p, two 2K AI character portraits and three 1K montage panels by GPT Image 2, WhisperX word alignment, split-screen interview layout, speaker-aware karaoke captions, a product-handoff moment and background music, concurrently rendered in 64 headless Chromium processes.</p><p>Three clones included: swap both hosts to Pepe and Doge arguing about doggy arms, replace the creatine with retinol where a pretty boy roasts a tomboy's pores, or ditch the physical product for a CheatGPT app where a himbo jock out-GPAs a PhD student — same podcast format, three ad verticals.</p><p>Total cost: <b>$1.07</b>.</p></td>@@ -110,14 +110,14 @@ the Skill prepares the executable Hypit Distribution separately; your video proj<tr><th width="16%">Reference</th><td width="28%"></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/666ad535-3231-44fb-b9bc-271817ae79de" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-reference.mp4" controls muted></video></td><td width="28%"></td></tr><tr><th width="16%">Clones</th>- <td width="28%"><video src="https://github.com/user-attachments/assets/c39a0425-2dcb-4709-b894-6a9423d351e3" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/8f71552c-0ad1-4d29-8c4e-3b937ab7c887" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/d9cab2e7-e08b-48ef-8d25-bc28ca9efc17" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-clone-1.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-clone-2.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-clone-3.mp4" controls muted></video></td></tr><tr><td colspan="4"><p><b>"NICE RIDE"</b> — a 26-second street interview where a mob wife drops three rules for making her first million. Three A-rolls by Seedance 2 Mini 720p, one 2K AI character portrait by GPT Image 2, WhisperX word alignment, head-tracked speaker-colored captions driven by face bounding boxes from Google Video Intelligence and YOLOv8 AnimeFace, a sound-synced emoji reveal board with color flashes and reveal sound effects, plus background music, concurrently rendered in 64 headless Chromium processes.</p><p>Three clones included: swap hosts to Wojak and Chad, translate everything to Spanish with exactly the same punchlines, or swap the Lambo for an F1 car where Ada explains to Leon how driving Uber led to an accidental Grand Prix win — same three-stage reveal, distinct street-interview remixes.</p><p>Total cost: <b>$1.09</b>.</p></td>@@ -166,7 +166,7 @@ Drop in a video and your agent clones the whole workflow — or describe what yoStar us, and you will receive all release notifications from GitHub without any delay!-+## How to Contributediff --git a/README.zh-CN.md b/README.zh-CN.mdindex be8e2445..5d8c9e70 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -43,7 +43,7 @@ Hypit 为 AI Agent(Claude Code、Codex 等)提供了一套制作视频的语**需要说明的是:** 复刻视频是最快的入口,但不是唯一的入口。你可以从我们的模板开始,也可以描述你想要的视频,让 Agent 从零写出一份 workflow。生成模型同样不是必需的:字幕、动效和代码渲染的画面,不调用任何模型也能编译成一条成片,一条视频的成本可以正好是 $0。-+<p align="center"><em>左侧是 SVML 源文件,右侧实时呈现对应视频。</em></p>@@ -53,8 +53,8 @@ Hypit 为 AI Agent(Claude Code、Codex 等)提供了一套制作视频的语npx skills add hypit-ai/hypit -g```-OpenAgents 等 Skill Hub 安装的是同一个 `skills/hypit/` 真目录。首次使用时,Skill 会另行准备-可执行的 Hypit Distribution;视频项目可以放在任意位置。+这条命令安装 Skill。首次使用时,Agent 会检查 Hypit 可执行程序,并按需协助安装。+视频项目可以放在任意位置。## 示例@@ -66,14 +66,14 @@ OpenAgents 等 Skill Hub 安装的是同一个 `skills/hypit/` 真目录。首<tr><th width="16%">参考视频</th><td width="28%"></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/f573bdac-62da-4b5d-825d-54d5880a7026" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-reference.mp4" controls muted></video></td><td width="28%"></td></tr><tr><th width="16%">复刻视频</th>- <td width="28%"><video src="https://github.com/user-attachments/assets/3ffd9951-e423-4a48-ad8f-5c596627be69" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/eb62372d-2464-4a4b-83ee-41e227f99a8e" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/9ba050f6-355d-460c-b684-7344cf49c051" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-clone-1.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-clone-2.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/ugc-clone-3.mp4" controls muted></video></td></tr><tr><td colspan="4"><p><b>“GOAT DEBATE”</b>——一条 20 秒的足球 Tier List,把 Ronaldo 排进 D 级,把 Messi 排进 S 级。A-roll 是两段 Seedance 2 Mini 生成的 720p 吐槽片段,B-roll 是 GPT Image 2 生成的一张 2K 哥特女孩肖像和十张 1K 脑腐图;WhisperX 负责逐词对齐,排行榜跟着音效逐条落位,再配上彩色词盒卡拉 OK 字幕、丝滑的动画和抓耳的背景音乐,最后由 64 个无头 Chromium 进程并发渲染。</p><p>上面给出了三个复刻版本:把解说员换成香蕉猫;翻转排名,让 Ronaldo 成为 GOAT;把所有球员换成科技公司创始人。同一套爆款结构,可以产出完全不同的爆款视频。</p><p>总成本:<b>$1.15</b>。</p></td>@@ -88,14 +88,14 @@ OpenAgents 等 Skill Hub 安装的是同一个 `skills/hypit/` 真目录。首<tr><th width="16%">参考视频</th><td width="28%"></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/22df72b8-4831-4eb6-957d-676ae9b04f2d" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-reference.mp4" controls muted></video></td><td width="28%"></td></tr><tr><th width="16%">复刻视频</th>- <td width="28%"><video src="https://github.com/user-attachments/assets/9c14c5ae-bd12-4961-9d57-a46d3a2154c6" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/f44c653b-f520-4715-9530-4c2f42114387" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/92f9bf8b-4f83-4d9b-a0e8-ca27fab2cc94" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-clone-1.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-clone-2.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/podcast-clone-3.mp4" controls muted></video></td></tr><tr><td colspan="4"><p><b>“DAILY CREATINE”</b>——一条 18 秒的播客片段,肌肉芭比向一个瘦弱的大学生强推肌酸。A-roll 是 Seedance 2 Mini 生成的三段 720p 对峙镜头,外加一段展示理想生活方式的 B-roll;图像是 GPT Image 2 生成的两张 2K AI 角色肖像和三张 1K 蒙太奇画面。WhisperX 负责逐词对齐,再配上分屏访谈版式、区分说话人的卡拉 OK 字幕、产品递出的瞬间和背景音乐,最后由 64 个无头 Chromium 进程并发渲染。</p><p>上面给出了三个复刻版本:把两位主播换成 Pepe 和 Doge,争论狗狗手臂;把肌酸换成视黄醇,让漂亮男孩吐槽假小子的毛孔;把实体产品换成 CheatGPT 应用,让头脑简单的体育生绩点碾压博士生。同一套播客形式,三个广告垂类。</p><p>总成本:<b>$1.07</b>。</p></td>@@ -110,14 +110,14 @@ OpenAgents 等 Skill Hub 安装的是同一个 `skills/hypit/` 真目录。首<tr><th width="16%">参考视频</th><td width="28%"></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/666ad535-3231-44fb-b9bc-271817ae79de" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-reference.mp4" controls muted></video></td><td width="28%"></td></tr><tr><th width="16%">复刻视频</th>- <td width="28%"><video src="https://github.com/user-attachments/assets/c39a0425-2dcb-4709-b894-6a9423d351e3" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/8f71552c-0ad1-4d29-8c4e-3b937ab7c887" controls muted></video></td>- <td width="28%"><video src="https://github.com/user-attachments/assets/d9cab2e7-e08b-48ef-8d25-bc28ca9efc17" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-clone-1.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-clone-2.mp4" controls muted></video></td>+ <td width="28%"><video src="https://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/interview-clone-3.mp4" controls muted></video></td></tr><tr><td colspan="4"><p><b>“NICE RIDE”</b>——一条 26 秒的街头采访,黑帮太太分享赚到第一个一百万的三条规则。三段由 Seedance 2 Mini 生成的 720p A-roll,一张由 GPT Image 2 生成的 2K AI 角色肖像;WhisperX 负责逐词对齐,再利用 Google Video Intelligence 和 YOLOv8 AnimeFace 提供的人脸边界框,驱动跟随人脸的说话人专属彩色字幕;配合跟音效同步的表情符号揭示板、彩色闪烁、揭示音效和背景音乐,最后由 64 个无头 Chromium 进程并发渲染。</p><p>上面给出了三个复刻版本:把主播换成 Wojak 和 Chad;把所有内容翻译成西班牙语,同时保持完全相同的 punchline;或者把兰博基尼换成 F1 赛车,让 Ada 向 Leon 解释自己如何因为开 Uber 意外赢得大奖赛。同样的三阶段揭示结构,三种不同的街头采访混剪。</p><p>总成本:<b>$1.09</b>。</p></td>@@ -165,7 +165,7 @@ Agent 会检查环境,索要这条视频需要的凭据,生成素材并构给我们点个 Star,即可第一时间收到 GitHub 的所有版本发布通知!-+## 贡献指南diff --git a/docs/quickstart.md b/docs/quickstart.mdindex eabe42cf..238159c0 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -7,6 +7,9 @@ You do not need to know SVML, SVS, JavaScript or the command line. Describe yourlanguage; the Agent uses the `/hypit` skill to understand the reference, direct the work and delivera video with an editable project.+The recordings illustrate example conversations and editing views. Interface details and commands+may differ; the guidance below describes the current workflow.+## What you need- A Coding Agent that can use skills, such as Claude Code or Codex.@@ -22,13 +25,13 @@ npx skills add hypit-ai/hypit -gThen start a Coding Agent anywhere; the Hypit skill is available globally. The Skill suppliesproduction knowledge. The Agent checks whether the Hypit command is installed and sets up the-executable tools when needed.+executable tools when needed, explaining any setup that needs your choice.## 2. Describe the video you want-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/describe_the_video_you_want.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/describe_the_video_you_want.mp4"></video>-You can take either of two paths.+Start with a reference to adapt or an idea to develop.### Clone a reference video@@ -39,7 +42,7 @@ Ask the Agent to clone a video and provide its local file path:```You can also provide a link from an online video platform. The Agent uses `yt-dlp` to download the-source automatically. For example:+source from supported sites. For example:```text/hypit clone this video: https://www.youtube.com/watch?v=VIDEO_ID@@ -47,8 +50,8 @@ source automatically. For example:```Tell the Agent what should change, if anything: the host, language, product, aspect ratio, visual-style or call to action. The reference is treated as evidence about the editorial structure. The-Agent does not merely summarize it; it creates an editable program that can be reviewed and built.+style or call to action. The Agent studies what makes the reference work and adapts its script, performances and visual+relationships to your goal. You receive a finished video and an editable project.### Create an original video@@ -66,80 +69,92 @@ You can add constraints such as audience, duration, language, tone, brand colorsor aspect ratio. The Agent turns the brief into a complete plan and fills in production details fromthe information you provide.-## 3. Provide credentials when the Agent asks+## 3. Choose the services for your project++<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/provide_credentials_when_the_agent_asks.mp4"></video>++The Agent first checks the tools and services already available for this project. It explains any+missing capability and helps you choose how to provide it. For a spoken reference, WhisperX supplies+the transcript and word timings used to understand the video. The Agent checks for a local setup;+if needed, it can help prepare one or use a hosted service you choose.-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/provide_credentials_when_the_agent_asks.mp4"></video>+You can use your own provider accounts, or choose HypiHub for hosted transcription and generation+through one account. Tell the Agent which services you already use and whether you prefer local+setup or hosted tools. It opens login after you choose to connect that service. The recording shows+the HypiHub login option.-After you describe the video, the Agent checks which models and services the project needs. If a-required credential is missing, it will ask you for it and explain what it is used for. You have two-options:+Use the service's login or credential setup to connect your account. Credentials belong in the+configured credential store, while the project records which services to use.-1. **Use Hypit's recommended Hypit.ai OAuth login.** Tell the Agent to log in through hypit.ai. This- single OAuth flow covers all models that Hypit provides through its hosted service, so you do not- need to collect separate keys for each model.-2. **Use your own provider keys.** You can tell the Agent which models to use and provide API keys- from the corresponding providers. The Agent will request only the keys needed for this project- and will not ask for unrelated credentials.+## 4. Agree on the paid work-Never paste a secret into a public document or commit it to Git. The Agent stores credentials using-the configured secure credential store.+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/approve_and_submit_the_paid_build.mp4"></video>-## 4. Let the Agent do the production work+Before using a paid service, the Agent explains the account, work to be performed and available+pricing information. Agree on the production scope and budget, for example:++```text+Use my selected account to make this video, including transcription and media generation,+within a total budget of $5. Keep me informed as it progresses.+```-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/let_the_agent_do_the_production_work.mp4"></video>+Your authorization covers that agreed work as it proceeds. If you want only an analysis first,+authorize that scope; the production can be priced once its direction is clear. An expanded scope,+a different paying account or work beyond the budget brings a new decision back to you.++The recording illustrates approving a production request. Actual prices and local or hosted+processing depend on the services selected for your project.++## 5. Let the Agent produce the video++<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/let_the_agent_do_the_production_work.mp4"></video>The Agent understands the reference in terms of your goal. Timed frames and words help it explainthe story, pacing, and the purpose and timing of captions, B-roll and graphics. A replacement personor product shapes the script and creative direction from the beginning.-It records those decisions in project files, selects or writes suitable components, generates media,-and composes the video around its semantic timeline. Studio and selected-range renders help check-layout, timing and readability. The Agent reuses existing media and keeps you informed about material-decisions, progress and problems.+It records the direction, writes the image and performance prompts, and arranges the references+that connect the generated material. While independent generation is running, it can write the+components and prepare the composition. Spoken material supplies the semantic timing for captions+and graphics; wordless animation can use its own authored rhythm.-## 5. Review the composition in Studio+With the actual material available, the Agent checks how the layout, motion and timing work together+and refines the relevant components. Existing media stays available for reuse, and you receive+updates about creative decisions, progress and problems.-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/review_the_mock_studio.mp4"></video>+Builds save their completed media and outputs. If an attempt fails, the Agent explains what happened+and uses available work in a new Run and Build, within the agreed scope.-Studio displays the media, captions and graphics selected by the current Run. The Agent can inspect-composition with existing material and continue refining it as generated media becomes available.+## 6. Review the finished video-Check whether the story is clear, captions are readable, the product or ranking board has enough-prominence, and B-roll appears where it helps. Describe the change you want:+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/review_the_paid_result.mp4"></video>-```text-The board appears too late and the captions are too small. Bring the board in with the words-introducing the ranking, and make the captions larger.-```+When the Build finishes, the Agent provides the final video and its saved location. Review the+content, captions, transitions, framing and sound against your goal. Describe any changes you want;+the project retains editable Sources and generated media.-The Agent changes the relevant parts and shows the updated composition.+### Explore the editable project in Studio-## 6. Approve and submit the paid Build+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/review_the_mock_studio.mp4"></video>-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/approve_and_submit_the_paid_build.mp4"></video>+Alongside the finished video, the Agent can open Studio to show the editable composition. Its+Preview, Timeline and Inspector let you explore how the media, captions and graphics fit together.-Before new paid work, the Agent explains the selected models, expected external work and available-pricing information. Authorize a concrete production scope:+The recording shows the timeline and editing interface with placeholder media. In your project,+the Agent opens a Run that selects your existing production material. If you are working remotely,+a screenshot or short recording can introduce the project too.++You can make a concrete request such as:```text-Generate the media and finish the video with this direction, within the budget we agreed.+Bring the board in with the words introducing the ranking, and make the captions larger.```-The Agent submits a Build and follows its outcome. Completed media and outputs remain in the-project's Result. If an attempt fails, the Agent explains the failure and reuses available outputs-through a new Run and Build.--## 7. Review the finished video--<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/review_the_paid_result.mp4"></video>--When the Build finishes, the Agent provides the final video and its saved location. Review the-content, captions, transitions, framing and sound against your goal. Describe any changes you want;-the project retains editable Sources and generated media.+The Agent changes the relevant source or component and checks the updated composition.-## 8. Request natural-language changes+## 7. Request natural-language changes-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/request_natural_language_changes.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/request_natural_language_changes.mp4"></video>After a successful Build, you can continue directing the project conversationally. You may changethe host, replace B-roll, alter the ranking-board treatment, translate the script, adjust the tone or@@ -153,9 +168,9 @@ look like a paper sports magazine.The Agent traces each request to the relevant source and component, preserves what you asked it tokeep, and reuses existing outputs. New paid generation follows your authorized scope.-## 9. Create multiple variants in parallel+## 8. Create multiple variants in parallel-<video controls playsInline preload="metadata" width="100%" src="./quickstart/videos/create_multiple_variants_in_parallel.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/create_multiple_variants_in_parallel.mp4"></video>When you want several versions, first tell the Agent the dimensions that may vary. It will discussthe intended directions with you, for example:diff --git a/docs/zh/quickstart.md b/docs/zh/quickstart.mdindex 8d680511..d244ac3b 100644--- a/docs/zh/quickstart.md+++ b/docs/zh/quickstart.md@@ -5,6 +5,8 @@ description: 无需手写 SVML 或 SVS,通过 Coding Agent 创建、审阅并你不需要了解 SVML、SVS、JavaScript 或命令行。用日常语言向 Coding Agent 描述视频,Agent 会通过 `/hypit` skill 理解参考、设计内容、制作视频,并交付可继续修改的项目。+录屏用于展示对话和编辑操作。界面与个别命令可能有所不同,当前的使用方式请参照下文。+## 你需要准备什么- 一个能够使用 skill 的 Coding Agent,例如 Claude Code 或 Codex;@@ -18,15 +20,15 @@ description: 无需手写 SVML 或 SVS,通过 Coding Agent 创建、审阅并npx skills add hypit-ai/hypit -g```-然后在任意处启动 Coding Agent,Hypit skill 将全局可用。Skill 提供制作知识;Agent 会检查 Hypit 命令是否可用,并在需要时安装可执行工具。+然后在任意处启动 Coding Agent,Hypit skill 将全局可用。Skill 提供制作知识;Agent 会检查 Hypit 命令是否可用,并在需要时准备可执行工具,说明其中需要你选择的安装事项。### **👉 [免费获得 100 个拥有独特音色的 AI 人物形象](https://drive.google.com/drive/u/2/folders/18J9Fz7mkU3OQNJ-2Res3eIyFQ2cemIK5)**## 2. 描述你想制作的视频-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/describe_the_video_you_want.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/describe_the_video_you_want.mp4"></video>-你可以选择以下两种方式之一。+可以从一条想改编的参考视频开始,也可以从一个创意开始。### 复刻一条参考视频@@ -36,14 +38,14 @@ npx skills add hypit-ai/hypit -g/hypit 克隆这条视频:/path/to/video.mp4```-你也可以直接提供在线视频平台的链接。Agent 会使用 `yt-dlp` 自动下载视频。例如:+你也可以直接提供在线视频平台的链接。对于支持的平台,Agent 会使用 `yt-dlp` 下载视频。例如:```text/hypit 克隆这条视频:https://www.youtube.com/watch?v=VIDEO_ID/hypit 克隆这条视频:https://www.instagram.com/reel/REEL_ID/```-如果需要改变内容,也可以一并说明,例如更换主持人、语言、产品、画幅比例、视觉风格或行动号召。参考视频会被当作剪辑结构的证据;Agent 不会只给你一份分析报告,而是会创建一套可以审阅、修改和 Build 的完整视频程序。+如果需要改变内容,也可以一并说明,例如更换主持人、语言、产品、画幅比例、视觉风格或行动号召。Agent 会理解原片为什么有效,并根据你的目标改编剧本、人物表演和画面关系。你会得到成片和可继续编辑的项目。### 原创一条视频@@ -55,60 +57,67 @@ npx skills add hypit-ai/hypit -g你还可以补充目标受众、时长、语言、语气、品牌色、主持人、发布平台或画幅比例等要求。Agent 会把 brief 转换成完整计划,并自行补全制作所需的细节。-## 3. 按 Agent 提示提供凭据+## 3. 选择项目使用的服务-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/provide_credentials_when_the_agent_asks.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/provide_credentials_when_the_agent_asks.mp4"></video>-在你描述视频之后,Agent 会检查项目需要哪些模型和服务。如果缺少必要凭据,Agent 会向你询问,并说明该凭据的用途。你可以选择两种方式:+Agent 会先检查当前项目已有的工具和服务,说明缺少什么,并帮助你选择接入方式。对于有对白的参考视频,WhisperX 提供理解视频所需的转写和词时间。Agent 会检查本地是否已有可用环境;需要时,可以帮助准备本地环境,也可以使用你选择的托管服务。-1. **使用 Hypit 推荐的 hypit.ai OAuth 登录。** 告诉 Agent 通过 hypit.ai 登录。一次 OAuth 登录即可覆盖 Hypit 托管服务提供的所有模型,不需要为每个模型分别收集 key。-2. **使用你自己的 Provider key。** 你可以直接和 Agent 约定要使用哪些模型,并提供相应 Provider 的 API key。Agent 只会索取当前项目需要的 key,不会询问无关凭据。+你可以使用自己的 Provider 账号,也可以选择 HypiHub,通过一个账号使用托管转写和生成服务。告诉 Agent 你已经使用哪些服务,以及更倾向本地配置还是托管工具。确定连接某项服务后,它再打开登录。录屏展示的是 HypiHub 登录选项。-不要把密钥粘贴到公开文档中,也不要提交到 Git。Agent 会使用已配置的安全凭据存储来保存这些凭据。+通过服务的登录或凭据配置完成连接。凭据保存在配置的凭据存储中,项目记录使用哪些服务。-## 4. 让 Agent 完成制作+## 4. 约定付费范围-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/let_the_agent_do_the_production_work.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/approve_and_submit_the_paid_build.mp4"></video>-Agent 会从你的目的出发理解参考视频,结合带时间的帧图和台词,弄清故事、节奏,以及字幕、B-roll、图形的作用与出现时机。换人或换产品的要求会从一开始影响剧本和设计。+使用付费服务前,Agent 会说明使用的账号、准备执行的工作和可查到的价格信息。一起确定制作范围与预算,例如:-它把这些决定写入项目文件,选择或编写合适的组件,用图片与视频模型制作素材,再按语义时间线编排。Studio 和局部渲染帮助检查版面、时机与可读性。已有素材会被复用;重要的决定、进展和问题会及时告诉你。+```text+使用我选定的账号完成这条视频,包括转写和素材生成,总预算不超过 5 美元。制作过程中及时告诉我进展。+```-## 5. 在 Studio 查看编排+这份授权覆盖约定范围内后续开展的工作。如果你只想先分析,就先授权分析;明确制作方向后,再估算制作费用。扩大范围、更换付费账号或超出预算时,再由你作出新的决定。-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/review_the_mock_studio.mp4"></video>+录屏展示如何确认一项制作请求。实际费用,以及哪些处理在本地或托管服务上执行,取决于当前项目选择的服务。-Studio 展示当前 Run 选定的素材、字幕和图形。Agent 可以用已有素材检查构图,也可以在生成素材后继续调整编排。+## 5. 让 Agent 制作视频-查看故事是否清楚、字幕是否易读、产品或 ranking 板是否突出、B-roll 是否放在合适的位置。直接描述你想要的改变:+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/let_the_agent_do_the_production_work.mp4"></video>-```text-ranking 板出现得太晚,字幕太小。让板子跟着介绍排名的台词出现,并把字幕放大一些。-```+Agent 会从你的目的出发理解参考视频,结合带时间的帧图和台词,弄清故事、节奏,以及字幕、B-roll、图形的作用与出现时机。换人或换产品的要求会从一开始影响剧本和设计。-Agent 会修改对应部分,再展示更新后的画面。+它记录制作方向,写好图片和表演的 prompt,安排素材之间的参考关系。独立素材正在生成时,可以同时编写组件、准备编排。有对白的素材提供字幕与图形所依附的语义时间;纯动画也可以按自身的表达节奏安排时间。-## 6. 确认后提交付费 Build+实际素材到位后,Agent 检查版面、运动和时机如何配合,并调整相应组件。已有素材保留用于复用;创作决定、进展和问题会及时告诉你。-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/approve_and_submit_the_paid_build.mp4"></video>+Build 会保存已完成的素材和输出。如果某次执行失败,Agent 会说明情况,并在约定范围内通过新的 Run 和 Build 使用已有成果继续制作。-开始新的付费工作前,Agent 会说明所选模型、将要执行的外部工作和可查到的价格信息。你可以授权明确的制作范围:+## 6. 查看成片-```text-按这个方案生成素材并完成视频,预算在我们刚确认的范围内。-```+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/review_the_paid_result.mp4"></video>-Agent 提交 Build 并跟进结果。已完成的素材和输出会保存在项目的 Result 中;出现失败时,它会说明原因,并在新的 Run 和 Build 中复用可用产物。+Build 完成后,Agent 会提供最终视频及保存位置。查看内容、字幕、转场、构图和声音是否符合你的目标。需要修改时,直接告诉 Agent;项目保留可编辑的源码和已生成素材。-## 7. 查看成片+### 在 Studio 里了解可编辑项目-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/review_the_paid_result.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/review_the_mock_studio.mp4"></video>-Build 完成后,Agent 会提供最终视频及保存位置。查看内容、字幕、转场、构图和声音是否符合你的目标。需要修改时,直接告诉 Agent;项目保留可编辑的源码和已生成素材。+交付成片时,Agent 也可以打开 Studio,展示这条视频的可编辑编排。你可以通过预览、时间线和属性面板,了解素材、字幕与图形如何配合。++录屏用占位素材展示时间线和编辑界面。在你的项目里,Agent 会打开选用了实际制作素材的 Run。远程协作时,也可以通过截图或短录屏了解项目。++你可以提出具体要求,例如:++```text+让 ranking 板跟着介绍排名的台词出现,并把字幕放大一些。+```++Agent 会修改对应的源码或组件,并检查更新后的编排。-## 8. 继续用自然语言提出修改+## 7. 继续用自然语言提出修改-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/request_natural_language_changes.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/request_natural_language_changes.mp4"></video>Build 成功后,你仍然可以用对话继续指导项目。你可以更换主持人、替换 B-roll、改变 ranking 板的样式、翻译台词、调整语气或切换画幅比例。例如:@@ -118,9 +127,9 @@ Build 成功后,你仍然可以用对话继续指导项目。你可以更换Agent 会把每项要求落实到对应的源码和组件,保留你要求不变的部分,并复用已有产物。新的付费生成遵循你授权的范围。-## 9. 并行制作多个变体+## 8. 并行制作多个变体-<video controls playsInline preload="metadata" width="100%" src="../quickstart/videos/create_multiple_variants_in_parallel.mp4"></video>+<video controls playsInline preload="metadata" width="100%" src="https://storage.googleapis.com/hypit-public-assets/quickstart/2026-09-09/create_multiple_variants_in_parallel.mp4"></video>如果需要多个版本,先告诉 Agent 哪些维度可以变化。它会与你讨论具体方向,例如:diff --git a/skills/hypit/references/playbooks/craft/examples/image-direction.md b/skills/hypit/references/playbooks/craft/examples/image-direction.mdindex 2aa4f0a8..6916147b 100644--- a/skills/hypit/references/playbooks/craft/examples/image-direction.md+++ b/skills/hypit/references/playbooks/craft/examples/image-direction.md@@ -11,7 +11,7 @@ with the result it describes.## Goth girl outside a Korean cafe-+Production example: the prompt below was used directly to generate the shown image.@@ -66,7 +66,7 @@ The four paragraphs keep their roles; the scene determines their particular fram## Shanghai record-store owner-+Here the striking beauty and cool music-lover presence have a different expression: a bob, jade-greenknit, headphones, and a few record-shop details. Green clothing and walnut shelves distinguish the@@ -119,7 +119,7 @@ Look at that image and direct its appeal within the target work, using the same## Mob Wife: strong glamour in a captured world-+The beauty comparison and "Stay out of my husband's business" give this person a vivid presence.Fur, layered gold, red lips, and an expensive restaurant reinforce it. Simple material names leave@@ -143,7 +143,7 @@ The restaurant's background palette is mainly red and gold. It feels like an ups## Orange-cat CEO: comic authority through body and setting-+The boss's authority organizes the picture. A round face, large belly, crooked tie, straining suitbuttons, and undersized cat tree make that authority funny. A leather chair, office window, laptop,@@ -165,7 +165,7 @@ The office's background design combines gray and orange textures. It looks like## Mermaid: an impossible subject in a photographed world-+The mermaid identity, explicit beauty, and friendly curiosity direct the person. Wet hair, shells,pearls, coral, and fish establish the underwater world. Sea blue and coral orange give it a color