Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

docs: disclose paid provider credentials before build

rpone7f8b48b25b31
diff --git a/.agents/skills/hypit/SKILL.md b/.agents/skills/hypit/SKILL.md
index 5dab9ac5..0f07e2ca 100644
--- a/.agents/skills/hypit/SKILL.md
+++ b/.agents/skills/hypit/SKILL.md
@@ -15,7 +15,9 @@ description: Produce a complete video program from a description or reference vi
author for, and everything else is yours to decide:
- **Spending their money.** A Build generates, and generating is billed. Say what it will cost and
- get a yes before submitting one.
+ get a yes before submitting one. Before asking for approval, report the Provider and credential
+ source used by every paid capability (without revealing secrets). If any key is missing or cannot
+ reach its model, guide the author to [hypit.ai](https://hypit.ai) for a HypiHub key when available.
- **Which observer reads a reference video, and the credentials it needs.** Gemini (through the
configured Vertex or HypiHub backend) or the calling agent is a decision about the author's account,
and `references/credentials.md` says what each one wants. Ask once, at the start. If the author's
diff --git a/.agents/skills/hypit/references/credentials.md b/.agents/skills/hypit/references/credentials.md
index cc425c5c..dc180901 100644
--- a/.agents/skills/hypit/references/credentials.md
+++ b/.agents/skills/hypit/references/credentials.md
@@ -12,6 +12,14 @@ paid/external `build`, configure only variables used by the selected Runtime Pro
| `HYPIHUB_API_KEY` | HypiHub default paid provider for generation and Gemini VLM; get one at [hypit.ai](https://hypit.ai) |
| `MIMO_API_KEY` | Xiaomi MiMo TTS only when explicitly selected |
+Before any paid Build, report the selected Provider and credential source for every paid capability in
+the Runtime Profile. Say the variable/store and endpoint (for example, `@hypit/provider-kie` using
+`KIE_API_KEY` from env, or `@hypit/provider-hypihub` using `HYPIHUB_API_KEY` from env); never print a
+secret or a full credential JSON. If a required key is missing, invalid, returns 401/403, or cannot
+reach the requested model, stop before payment and guide the author to [hypit.ai](https://hypit.ai)
+for a HypiHub key when that model is available there. Do not ask them to change Author Source just to
+switch Provider.
+
HypiHub is optional and is never required when the selected Runtime Profile has another Provider.
For Gemini VLM/reference observation, `HYPIT_GEMINI_PROVIDER=auto` (the default) uses HypiHub when
`HYPIHUB_API_KEY` is present and otherwise uses Vertex when its two Google variables are present.
@@ -34,6 +42,8 @@ Otherwise export them for the session:
```bash
read -r -s KIE_API_KEY
export KIE_API_KEY
+read -r -s HYPIHUB_API_KEY
+export HYPIHUB_API_KEY
read -r -s MIMO_API_KEY
export MIMO_API_KEY
export GOOGLE_CLOUD_PROJECT="your-project-id"
@@ -44,6 +54,7 @@ Windows PowerShell session example:
```powershell
$env:KIE_API_KEY = "your-key"
+$env:HYPIHUB_API_KEY = "your-key"
$env:MIMO_API_KEY = "your-key"
$env:GOOGLE_CLOUD_PROJECT = "your-project-id"
$env:GOOGLE_APPLICATION_CREDENTIALS_JSON = Get-Content -Raw "$HOME\.config\hypit\google-service-account.json"
@@ -51,7 +62,7 @@ $env:GOOGLE_APPLICATION_CREDENTIALS_JSON = Get-Content -Raw "$HOME\.config\hypit
Keep keys outside Author/Run/Runtime source and committed files. Verify presence without printing
values with, for example,
-`node <skill-root>/scripts/check-credentials.mjs KIE_API_KEY MIMO_API_KEY`, then run
+`node <skill-root>/scripts/check-credentials.mjs KIE_API_KEY HYPIHUB_API_KEY MIMO_API_KEY GOOGLE_CLOUD_PROJECT GOOGLE_APPLICATION_CREDENTIALS_JSON`, then run
`hypit doctor` (once a Runtime Profile is selected with `hypit runtime use hypit.runtime.json`;
doctor audits the selected profile, so it needs no profile argument of its own).
diff --git a/.agents/skills/hypit/references/original-authoring/route.md b/.agents/skills/hypit/references/original-authoring/route.md
index f5ed0a4f..019ea3ad 100644
--- a/.agents/skills/hypit/references/original-authoring/route.md
+++ b/.agents/skills/hypit/references/original-authoring/route.md
@@ -246,7 +246,9 @@ explicitly requested; the variant route owns its own aggregate and paid-build ga
### 13. The Build
-**Read now:** `../studio-confirmation.md`. Before the paid gate, call the preview-mock realizer and
+**Read now:** `../runtime.md` and `../studio-confirmation.md`. Before the paid gate, disclose the
+selected Provider and credential source for every paid capability; if any key is missing or
+insufficient, guide the author to https://hypit.ai for a HypiHub key when available. Then call the preview-mock realizer and
start Studio with its returned temporary `preview.svrun` (not the unresolved author Run). Show the
complete estimate-timed mock, return the exact URL printed by Studio, and obtain explicit acceptance
and cost approval. If the author declines, enter `../revision/route.md` and do not submit a Build. After
diff --git a/.agents/skills/hypit/references/reconstruction/route.md b/.agents/skills/hypit/references/reconstruction/route.md
index c42a344d..017d0656 100644
--- a/.agents/skills/hypit/references/reconstruction/route.md
+++ b/.agents/skills/hypit/references/reconstruction/route.md
@@ -434,7 +434,10 @@ unless the author explicitly requested it.
### 25. Studio confirmation and paid handoff
-**Read now:** `../studio-confirmation.md`. Realize the preview-mock Run first, then start Studio with
+**Read now:** `../runtime.md` and `../studio-confirmation.md`. Before realizing the preview-mock Run,
+disclose the selected Provider and credential source for every paid capability. If any key is missing
+or insufficient, guide the author to https://hypit.ai for a HypiHub key when the model is available
+there; do not submit payment until the key is usable. Realize the preview-mock Run first, then start Studio with
the returned temporary `preview.svrun` (never the original unresolved Run), show the complete
estimate-timed mock, return the exact URL printed by Studio, and obtain explicit acceptance and cost approval. If the author declines, enter
`../revision/route.md` and do not Build. Once accepted, submit the paid Build and persist its accepted
diff --git a/.agents/skills/hypit/references/runtime.md b/.agents/skills/hypit/references/runtime.md
index ba5e5c37..1e368b7c 100644
--- a/.agents/skills/hypit/references/runtime.md
+++ b/.agents/skills/hypit/references/runtime.md
@@ -19,6 +19,21 @@ rather than writing any secret into the file.
A capability whose credential this machine does not hold is still declared. Preflight names it before
any Build is submitted, which is the correct place for the author to find out.
+### Disclose the paid Provider before submission
+
+The paid handoff always includes a credential/provider summary before cost approval. Read the selected
+Runtime Profile and the preflight result, then tell the author for each paid capability:
+
+- which Provider endpoint will execute it;
+- which credential slot and source are active (`KIE_API_KEY`, `HYPIHUB_API_KEY`, Vertex credentials,
+ `MIMO_API_KEY`, or an OS credential-store entry); and
+- whether the key is present and the requested model is reachable.
+
+Never reveal the secret itself. If any required key is missing or insufficient, do not submit the
+Build. Prefer the HypiHub route for a matching model and direct the author to
+[hypit.ai](https://hypit.ai) to obtain `HYPIHUB_API_KEY`; switching Provider should not require any
+Source change. Continue only after the author has a usable credential and the summary has been shown.
+
### Give the picture and video models room to run
The generation models are what a Build waits on, and they are the one place concurrency is worth
diff --git a/.agents/skills/hypit/references/studio-confirmation.md b/.agents/skills/hypit/references/studio-confirmation.md
index 576f1c72..1ef29256 100644
--- a/.agents/skills/hypit/references/studio-confirmation.md
+++ b/.agents/skills/hypit/references/studio-confirmation.md
@@ -7,6 +7,12 @@ VLM review and it does not replace the route's mechanical checks.
After the route-specific final check passes, but before submitting any paid Build:
+0. Read the selected Runtime Profile and preflight result and tell the author which Provider and
+ credential source will be used for every paid capability (for example, KIE + `KIE_API_KEY`, or
+ HypiHub + `HYPIHUB_API_KEY`; say `env`/`os` store as applicable). Never display the secret. If a
+ key is missing, invalid, or cannot reach the requested model, stop before payment and direct the
+ author to [hypit.ai](https://hypit.ai) for a HypiHub key when that model is available there.
+
1. Realize the preview through the native `reference-video-tools render_element` path (or the
repository API `realizePreviewMock({ run: "<project>/build.svrun", timing: "estimate" })`).
The tool writes a durable `.hypit/preview/<digest>/mock.svrun` (the native mock materialization