From fa859596a6068488a238e9ac10e959105348d9db Mon Sep 17 00:00:00 2001 From: Hochul Seok Date: Fri, 26 Jun 2026 23:31:44 +0900 Subject: [PATCH 1/2] Split API Keys into its own HPP Hub page The Hub app moved API key management out of Wallets into a dedicated "API Keys" menu (issue keys + browse the HPP Router model/pricing list). Mirror that in the guide: - Add hub/api-keys.md documenting key creation, the model tables, an example request, and links into the new HPP Router guide. - Trim hub/wallets.md to Credits, Personal Wallet (EOA), and MPC Wallet; point readers to the API Keys page for keys. - Register api-keys in the Hub sidebar (after Wallets). - Update intro / getting-started / playground / faq cross-references and link AI-model mentions to /hpp-router. Correct the model lineup (Claude, GPT, Kimi, plus free open models) to match the live Hub. --- hub/api-keys.md | 65 ++++++++++++++++++++++++++++++++++++++++++ hub/faq.md | 10 +++++-- hub/getting-started.md | 4 ++- hub/intro.md | 6 ++-- hub/playground.md | 6 ++-- hub/wallets.md | 37 ++++++++---------------- sidebarsHub.ts | 1 + 7 files changed, 96 insertions(+), 33 deletions(-) create mode 100644 hub/api-keys.md diff --git a/hub/api-keys.md b/hub/api-keys.md new file mode 100644 index 0000000..f60cff8 --- /dev/null +++ b/hub/api-keys.md @@ -0,0 +1,65 @@ +--- +title: API Keys +--- + +# API Keys + +The **API Keys** page is where you create keys for **HPP Router** — HPP's AI model +gateway — and browse the models you can call from your own code. + +> **Moved here:** API keys used to live on the Wallets page. They now have their own +> **API Keys** menu item, next to a full model and pricing list. + +## Create an API key + +1. Open **API Keys** from the left sidebar. +2. Select **Create Key** and give it a name. +3. Copy the key and store it somewhere safe. + +You can create several keys and revoke any of them at any time. Treat a key like a +password — keep it server-side and never commit it to source control. + +> **Note:** API usage and the Playground draw from the same **Credits**. Top up on the +> [Wallets](./wallets) page. + +## Browse available models + +The page lists every model HPP Router can route to, in two tables: + +- **Text models** — chat and code models from providers such as Anthropic (Claude), + OpenAI (GPT), and Moonshot AI (Kimi), plus free open models. Each shows its input and + output price per million tokens (MTok). +- **Image models** — image-generation models, priced the same per-use way. + +The list and prices shown in the Hub are always current, so check there for the +definitive catalog. + +## Make a request + +Your key works with any OpenAI-compatible client. Point the base URL at HPP Router and +send the key as a Bearer token: + +```bash +curl https://router.hpp.io/llm/v1/chat/completions \ + -H "Authorization: Bearer YOUR_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "model": "hpprouter/auto", + "max_tokens": 1024, + "messages": [{"role": "user", "content": "Hello!"}] + }' +``` + +The virtual `hpprouter/auto` model lets HPP Router pick a cost-appropriate model for each +request. To call a specific model, use its full id (for example `anthropic/claude-sonnet-4-6`). + +## Full HPP Router guide + +API keys are issued for **HPP Router**, HPP's OpenAI-compatible model gateway. For the +complete reference — authentication, streaming, the model catalog and pricing, smart +routing, and SDKs — see the dedicated guide: + +- [HPP Router overview](/hpp-router) +- [Quickstart](/hpp-router/quickstart) +- [Authentication](/hpp-router/authentication) +- [Models & Pricing](/hpp-router/models-and-pricing) diff --git a/hub/faq.md b/hub/faq.md index 3acf80f..6cd8d91 100644 --- a/hub/faq.md +++ b/hub/faq.md @@ -23,8 +23,14 @@ available on the production Hub. ### Which AI models can I use? -A wide range, including Claude, GPT, Llama, and Qwen models. The full list and pricing is -on the **Wallets** page in the Hub. +A wide range, including Claude, GPT, and Kimi models, plus free open models. The full list +and pricing is on the **[API Keys](./api-keys)** page in the Hub — these models are served +by [HPP Router](/hpp-router). + +### Can I use the AI models from my own code? + +Yes. Create an API key on the **[API Keys](./api-keys)** page and call the models through +[HPP Router](/hpp-router), HPP's OpenAI-compatible gateway. ### Are my conversations private? diff --git a/hub/getting-started.md b/hub/getting-started.md index 428e399..c5ebca4 100644 --- a/hub/getting-started.md +++ b/hub/getting-started.md @@ -17,8 +17,10 @@ Once you're signed in, the left sidebar has everything you need: - **Home** — start a new build or pick a guided prompt - **Playground** — build apps and games, and chat with AI models -- **Wallets** — your Credits, wallet, and API keys +- **Wallets** — your Credits and on-chain wallets +- **API Keys** — issue keys for HPP Router and browse available models - **Settings** — account, security, and invites +- **Support** — get help from the HPP team A secure wallet on HPP Mainnet is created for you automatically — no setup required. diff --git a/hub/intro.md b/hub/intro.md index 11631ad..2472fb7 100644 --- a/hub/intro.md +++ b/hub/intro.md @@ -24,8 +24,10 @@ preview you can test and publish. ## What's inside - **Playground** — describe what to build, preview and publish it, and chat with leading - AI models (Claude, GPT, Llama, Qwen). -- **Wallets** — your Credit balance, a built-in wallet on HPP Mainnet, and API keys. + AI models (Claude, GPT, Kimi, and more). +- **Wallets** — your Credit balance and your on-chain wallets on HPP Mainnet. +- **API Keys** — issue keys for [HPP Router](/hpp-router) and call HPP's AI models from + your own code. - **Credits** — pay-as-you-go, topped up with USDC.e on HPP Mainnet. ## Verifiable by design diff --git a/hub/playground.md b/hub/playground.md index cde7074..45e9257 100644 --- a/hub/playground.md +++ b/hub/playground.md @@ -24,8 +24,8 @@ Your projects save automatically — continue from **Home** or the project list. ## Chat with AI models -The Playground is also a chat with AI models provided through **HPP Router**. Pick a model -from the selector at the top: +The Playground is also a chat with AI models provided through **[HPP Router](/hpp-router)**. +Pick a model from the selector at the top: - **Claude Sonnet 4.6** — latest Claude Sonnet, excellent coder - **Claude Haiku 4.5** — fast and efficient @@ -33,7 +33,7 @@ from the selector at the top: - **GPT-5 Mini** — lightweight but intelligent - **GPT-OSS 120B** — open-source model -…and more. See the full list and pricing in [Wallets](./wallets#available-models). +…and more. See the full list and pricing on the [API Keys](./api-keys) page. ## Verify a response on-chain diff --git a/hub/wallets.md b/hub/wallets.md index 7453f7c..981fea1 100644 --- a/hub/wallets.md +++ b/hub/wallets.md @@ -4,38 +4,25 @@ title: Wallets # Wallets -The **Wallets** page is where you manage Credits, your on-chain wallet, and API keys. +The **Wallets** page is where you manage your **Credits** and your on-chain wallets. + +> **Looking for API keys?** They now have their own [API Keys](./api-keys) page. ## Credits Your **Credit balance** powers everything you do in HPP Hub — building, previews, and AI chat. Usage is pay-as-you-go. -To add Credits, select **Buy Credit** and pay with **USDC.e on HPP Mainnet**. - -## Your wallet - -HPP Hub gives every member a secure, non-custodial **wallet on HPP Mainnet** — created -automatically, with no setup required. You can view its address and any NFTs you've minted -from the Wallets page. - -### Connect a personal wallet (optional) - -You can also connect your own EVM-compatible wallet to link your address and view your -staked HPP. - -## API keys - -Create an **API key** on the Wallets page to use HPP Hub's AI models from your own code. -Keep your keys secret; you can create and revoke them at any time. +To add Credits, select **Buy Credit** and pay with **USDC.e on HPP Mainnet**. -## Available models +## Personal Wallet (EOA) -HPP Hub offers a wide range of AI models, provided through **HPP Router** — dozens of text -models and image models, each with its own per-use pricing. +Connecting a personal wallet is **optional**. Use **Connect Wallet** to link your own +EVM-compatible wallet — this lets you link your address and view your **staked HPP** +amount. -The **full, always-current list of models and prices** is shown on the **Wallets** page in -the Hub. +## MPC Wallet -> **Note:** a dedicated **HPP Router** guide — covering the API and the complete model -> catalog — is coming soon. +Every member gets a secure **MPC wallet on HPP Mainnet**, created automatically with no +setup required. From the Wallets page you can view its address (with a link to the block +explorer) and any NFTs you've minted. diff --git a/sidebarsHub.ts b/sidebarsHub.ts index 3dae2d2..0882c1a 100644 --- a/sidebarsHub.ts +++ b/sidebarsHub.ts @@ -9,6 +9,7 @@ const sidebars: SidebarsConfig = { 'getting-started', 'playground', 'wallets', + 'api-keys', 'settings', 'faq', ], From 212abca9c523324f5fc37298a73710a19fb68e53 Mon Sep 17 00:00:00 2001 From: Hochul Seok Date: Fri, 26 Jun 2026 23:49:20 +0900 Subject: [PATCH 2/2] Refine HPP Hub wording from a user's perspective - api-keys: drop the "Moved here" migration note. - wallets: neutral, present-tense pointer to the API Keys page (no "now have their own" framing). - playground: lead the chat section with "chat with leading AI models" instead of the HPP Router gateway detail (kept on API Keys / FAQ / Overview, where API use is the point). --- hub/api-keys.md | 3 --- hub/playground.md | 4 ++-- hub/wallets.md | 2 +- 3 files changed, 3 insertions(+), 6 deletions(-) diff --git a/hub/api-keys.md b/hub/api-keys.md index f60cff8..55c1e62 100644 --- a/hub/api-keys.md +++ b/hub/api-keys.md @@ -7,9 +7,6 @@ title: API Keys The **API Keys** page is where you create keys for **HPP Router** — HPP's AI model gateway — and browse the models you can call from your own code. -> **Moved here:** API keys used to live on the Wallets page. They now have their own -> **API Keys** menu item, next to a full model and pricing list. - ## Create an API key 1. Open **API Keys** from the left sidebar. diff --git a/hub/playground.md b/hub/playground.md index 45e9257..80dd12a 100644 --- a/hub/playground.md +++ b/hub/playground.md @@ -24,8 +24,8 @@ Your projects save automatically — continue from **Home** or the project list. ## Chat with AI models -The Playground is also a chat with AI models provided through **[HPP Router](/hpp-router)**. -Pick a model from the selector at the top: +The Playground is also a place to **chat with leading AI models**. Pick a model from the +selector at the top: - **Claude Sonnet 4.6** — latest Claude Sonnet, excellent coder - **Claude Haiku 4.5** — fast and efficient diff --git a/hub/wallets.md b/hub/wallets.md index 981fea1..76c6b26 100644 --- a/hub/wallets.md +++ b/hub/wallets.md @@ -6,7 +6,7 @@ title: Wallets The **Wallets** page is where you manage your **Credits** and your on-chain wallets. -> **Looking for API keys?** They now have their own [API Keys](./api-keys) page. +> **Note:** API keys are managed on the [API Keys](./api-keys) page. ## Credits